疊來套去的scope語句

寫作事件時，我們都按照觸發(fā)時機地點——>找到目標——>處理目標的思路進行分析，其中找到目標這一部分，往往就是指找到目標對應的scope。這一章我們將聚焦于各種scope的跳躍和調(diào)用語句，讓各位對scope的利用有一個比較好的理解，順利地找到自己的理想對象（笑）。

1 對象轉換——scope跳躍與調(diào)用語句的簡要介紹

在蠢驢語言的結構中，scope是表達的主語，相信大家已經(jīng)有所體會了。大多數(shù)事件都有它默認的基本scope（根/ROOT scope），例如country_event的基本scope便是觸發(fā)者對應的國家。

但是很多效果，都需要scope的轉換：比如人口的遷移需要尋找到一個國家的兩個星球，外交事件需要兩個國家之間的互動等等。這個時候就需要我們使用scope跳躍語句，對scope進行切換。

scope跳躍語句，是蠢驢effect和condition里一類語句的統(tǒng)稱。這類語句都用等號連接著一個{大括號}，在{大括號}內(nèi)的語句，在下一次scope跳躍前，就是在新的scope中，使用了新的主語。

另一方面，有些effect或者condition擁有復數(shù)個目標，例如判斷兩國是否在交戰(zhàn)狀態(tài)，或者改善兩國關系都需要兩個scope的支持。其中一個scope可以作為主語，但另一個scope呢？只能在這種語句中充當賓語的定位。

這種時候我們需要在語句中調(diào)用出另一個scope：使用scope調(diào)用語句，這一類語句可以指代一個scope，它們可以是特定的代碼流程詞匯，也可以是你事先保存的目標。

現(xiàn)在讓我們從最基礎的遍歷型開始，深入了解一下這些scope語句。

2 遍歷，還是遍歷——遍歷型scope跳躍語句

我在上一章就提到了這一類遍歷型scope跳躍語句，現(xiàn)在讓我們就下面的實例來對它們進行探究。

范例2-1 逃不過的清算

某個圓神信徒在完成了“清算后成功成為河長”的成就后，也興致沖沖地加入了mod制作的行列。第一步就是要加大它生存的難度，搞出各式各樣的圓神清算......

這一片代碼看起來好像比較復雜，但其實就是一串并列的效果組合在一起罷了。讓我們把代碼拆成一個個小的部分，看一看基礎的一些scope跳躍語句是如何使用的。

首先是遍歷型。這一類scope跳躍語句以any、every、random開頭，通常是對符合某一標準的群體，或是對這一群體中的隨機一個進行處理。

在effect區(qū)域內(nèi)，這些遍歷型scope跳躍語句以every或random打頭，分別代表所有和隨機一個。在condition區(qū)域內(nèi)，這種語句則以any開頭，代表任何一個的含義。

這些遍歷型scope跳躍語句可以滿足我們寫mod中查詢目標的絕大部分需求，下面由范例2-1，舉一些使用該語句進行事件制作的例子。

范例2-1-1 領袖老化

我們的圓神信徒首先決定從新國家的領袖下手，讓被清算國家在之后的每個月，領袖的年齡保持在150歲......雖然沒考慮壽命循環(huán)的要素，這樣一個高齡也極大增加了領袖存活的難度。

先我們需要用蠢驢語言翻譯這個需求，也就是每個月，該國家的全部領袖，設定年齡為150。目前不考慮觸發(fā)時間的每個月，我們需要先找到這些領袖，在觸發(fā)事件國家為ROOT的前提下。

這個遍歷型scope跳躍語句將scope由ROOT對應的觸發(fā)國家，轉換到了ROOT所擁有的全部領袖。每個擁有的領袖都會觸發(fā)大括號內(nèi)的effect，也就是：

這樣你就能夠令ROOT的所有領袖一夜白頭，前提是這些領袖的種族有頭發(fā)。

范例2-1-2 拆遷大隊

接下來這位仁兄想懲罰一下那些在銀河系中到處建造違章建筑的家伙，讓那些被戴森球遮擋的恒星重見天日...他計劃隨機挑選一個觸發(fā)國家的巨構，將其摧毀。

我們的新任務和范例2-1-1有什么區(qū)別呢？沒錯，數(shù)量。

我們不再需要選擇全部目標，而是要隨機挑選一個，這種時候every顯然就破壞力太大了，輪到我們的random登場：

然后很簡單的effect系列：

這兩個最簡單的effect帶領我們對every和random有了一些了解，接下來，讓我們看看any和limit的運用。

范例2-1-3 眾叛親離

為了更進一步地迫害玩家，這個modder決定從國家間的關系下手，全部的國家......不，應該把條件設的復雜一點，所有擁有擁有“靈能”特質人口的國家，對觸發(fā)國家的信任減少，怎樣？

好，現(xiàn)在難度上升了，我們剖析一下需求。

• 找到目標A：所有國家，條件為[擁有 擁有靈能特質的人口]

• 執(zhí)行effect，effect的目標有兩個，一個為觸發(fā)國家，一個是目標A。

讓我們一個個實現(xiàn)，首先是找到目標：既然目標還是所有國家，先寫一個這個：

但我們現(xiàn)在要找的并不是毫無限制，我們需要符合條件的國家，這時候我們就需要使用limit了：

通過加入limit，并在limit內(nèi)部填入condition，我們可以過濾我們需要選擇的目標，只讓符合條件的國家執(zhí)行接下來的effect。

接下來就是確認要符合的條件：[擁有 擁有靈能特質的人口]。我們要判斷這個國家擁有人口的情況，就需要在condition中進行scope跳躍。我們可以這樣：

在condition中的遍歷型scope跳躍語句，往往是以any開頭，這類語句的含義為任意一個，當存在任意一個滿足括號內(nèi)條件的目標，就返回真。

在這里，any_owned_pop就代表著任意一個擁有的人口，括號內(nèi)的scope切換至pop，使得我們可以運用pop對應的condition語句進行判斷。

接下來我們便可以進入effect的討論了，減少信任度——按照trust的自動補全，我們可以輕松地找到這樣的語句：

很快我們就發(fā)現(xiàn)這個語句需要兩個目標，其中一個是語句所在的scope，另一個，就是該語句屬性中的who了。

那么who應該對應的是什么呢？這個語句的效果是：增加[當前scope國家]對[who對應scope國家]的信任度，也就是說who要填入觸發(fā)國家對應的scope。

那么就應該這樣填寫：

……等一下。

ROOT？這是？

3 PREVPREV.FROMFROMFROM——流程scope跳躍語句

ROOT很明顯不是一個遍歷型scope跳躍語句。畢竟它不包含every或者random。很多時候我們會遇到像add_trust這樣，需要指定多個目標scope的effect語句，這時候我們除了需要尋找到多個對應的scope，還需要把這些scope正確地填入到effect的參數(shù)中。

這時候我們有兩種選擇，一種是event_target，我們之后會提到；另一種便是采用流程scope跳躍語句。這類語句不像遍歷型，它們往往并不能幫助我們找到符合條件的目標，相反，它們的作用是調(diào)用那些我們早已找到的目標，減少我們尋找的次數(shù)，實現(xiàn)只靠遍歷無法實現(xiàn)的功能。

一、就在此處——THIS

當前scope，當前scope我說著實在是過于繞口了，在蠢驢的語法中，現(xiàn)在所處的scope，被稱為THIS。

THIS指代的是當前所在的scope，例如范例2-1-3中add_trust所在位置的THIS就是every_country找到的國家。

像遍歷型一樣，你可以通過={}的方法把當前scope跳躍到THIS所對應的scope。此舉同時對effect和condition生效。

你可以寫這樣的代碼：

但這個代碼基本上沒有作用，THIS指代的是當前scope，從當前scope跳到當前scope是沒什么意義的（）

但THIS并非完全沒用，有一些語句雖然從字面意義上理解只需要一個目標，它們的目標并不是當前scope，而需要你進行額外的指定。例如下面這個：

不知道蠢驢為何這樣規(guī)定，你需要在等號后面確認目標：

因此理解THIS的含義也是相當重要的，接下來我會逐漸用THIS取代“當前scope”。

二、追本溯源——ROOT

在第一小節(jié)，我們提到大多數(shù)事件都有它默認的基本scope（根/ROOT scope），例如country_event的基本scope便是觸發(fā)者對應的國家。這個基本scope就是我們之前寫事件，沒有使用scope跳躍語句時一直處于的scope，能取得的，最基本的目標。

我們能夠使用的事件種類有很多：

• event （無ROOT）

• pop_event

• ship_event

• fleet_event

• planet_event

• system_event

• country_event

• observer_event

• starbase_event

• pop_faction_event

• first_contact_event

• espionage_operation_event

• ……

隨著版本更新，很多新的事件種類被添加到了群星中，蠢驢也不是只做了一些傻事（但太多事件種類還是過于繁瑣了）但對于剛進入事件寫作的你，我建議優(yōu)先使用以下的事件種類：

• country_event ROOT為觸發(fā)的國家，國家即玩家，易于理解。

• planet_event ROOT為觸發(fā)的星球，對于大多數(shù)劇情向事件，這樣的事件更方便你取到那個星球的相關信息，例如名字。

• event 沒有ROOT，主要用于全局設置，或者無可奈何的on_action限制。

• ship_event ROOT為觸發(fā)的艦船，挖墳都是這種事件，同樣，劇情方便。

當然這些事件除了基本的ROOT不同以外都有著類似的寫法，你選擇事件種類可以相當隨意......除了你在使用on_action的時候，會發(fā)現(xiàn)每種on_action都有著不同的event種類限制。

......看起來跑題了。

我們了解到每種事件的觸發(fā)者，基本scope，也就是ROOT之后，便可以看一下ROOT作為effect和condition在事件中的作用了。

就比方說范例2-1-3，我們見到了這樣的代碼：

蠢驢創(chuàng)造了ROOT這個東西，可不只是讓我們嘴上說說的。

通過ROOT，我們可以在事件中隨時調(diào)用其基本scope，就算你套了364層括號，我也能通過一層ROOT識破你的真面目。

ROOT在事件內(nèi)的任何地方都代表該事件的基本scope，除了在這類多目標語句內(nèi)可以作為目標指代，ROOT還能夠這樣使用：

像之前的THIS一樣，你可以通過={}的方法把當前scope跳躍到ROOT所對應的scope。此舉同時對effect和condition生效。

三、回憶上一步——PREV

那么除了ROOT，我們在之前的事件寫作中還找到了很多別的scope，它們不是事件的基本scope，無法通過ROOT來查找......難道必須使用event_target了嗎？大可不必（）

下一個殺器，PREV在事件中有著更加靈活的運用。

范例2-1-4 航道重組

是時候讓我們接觸一些更炫酷的功能了不是嗎？我們學會了遍歷型，還有著ROOT指引方向......我們的modder決定讓玩家帝國內(nèi)的航道發(fā)生改變，就想他玩過的更多巨構mod，其中的彭羅斯炸彈一樣。

他的需求是選擇觸發(fā)國家境內(nèi)的一個隨機星系，摧毀三條航道，然后與隨機相鄰星系創(chuàng)建三條航道。

這個玩意看上去有那么一點高端了，但確實一點也不復雜。

首先我們可以嘗試去找到目標：

沒錯，當你在VSC中輸入random或者every、any時，常常會出現(xiàn)驚喜（）很多蠢驢已經(jīng)用到的遍歷型scope跳躍語句極大簡化了我們的寫作難度。

while，一個非常常見的循環(huán)語句，在while里的語句會被重復執(zhí)行。限制執(zhí)行的次數(shù)有兩種方法，一種是count語句，如上圖，我們可以通過在while內(nèi)寫count=x來讓其內(nèi)部effect僅被執(zhí)行x次；另一種是使用limit，類似if，while只會在limit內(nèi)部條件成立時執(zhí)行內(nèi)部的effect。

在群星的mod制作中，while的執(zhí)行次數(shù)是有限的，也就是說會出現(xiàn)limit仍然滿足，while卻不再執(zhí)行的情況，需要注意。

其實遍歷型中的every已經(jīng)可以執(zhí)行很多循環(huán)的效果，所以建議多多思考來優(yōu)化關于循環(huán)的代碼，之后會詳細介紹。

接下來就要去執(zhí)行效果了。不過在此之前我們還需要考慮一個問題：相鄰星系就一定存在航道嗎？

顯然不是，那么我們就需要增加一個limit。

鏘鏘，PREV的初 次 登 場。（是不是還有奇怪的邏輯語句混入了？）

PREV和ROOT都是流程scope跳躍語句，和ROOT不同，PREV代表的是，切換至THIS（當前scope）之前的scope。有點繞？我們就該范例給一個詳細說明。

我們是如何找到目標星系的相鄰星系的？代碼經(jīng)歷了三個scope。

• 首先，我們利用random_system_within_border將scope由ROOT，也就是觸發(fā)國家切換到了隨機一個境內(nèi)的星系。

• 然后我們利用random_neighbor_system將scope由目標星系切換至其隨機一個相鄰星系，也就是THIS。

我們經(jīng)歷了兩次scope轉換，三個不同的scope。PREV就是抵達THIS（當前scope）在跳躍之前所處的scope，也就是這里random_system_within_border所選中的星系。要判斷其相鄰星系是否與其有航道連接，我們只需使用PREV便能解決目標尋找的問題。

x個PREV相連，可以指代x次跳躍前的scope，例如將范例中的PREV換為PREVPREV就會指代ROOT對應的觸發(fā)國家。（當然，對于has_hyperlane_to，PREVPREV是國家而不是星系，因此不是一個合法的目標。）

PREV和ROOT有著類似的特性，也就是說下面這樣是可行的：

如果你還是覺得判斷PREV是哪個有一點困難，你可以借助VSC的幫助：鼠標停留在任意語句上，你可以看到代碼介紹的方框中顯示著PREV和THIS，ROOT的scope種類，輔助你對代碼的選擇。

每個種類的scope都有不同的condition和effect，不匹配就會報錯，還請多多注意。

讓我們回到范例，完成這一段代碼：

add_hyperlane和remove_hyperlane對應著創(chuàng)建/刪除超時空航道，如圖，你可以發(fā)現(xiàn)這兩條代碼也與THIS不直接相關，需要你進行指定。

三、萌新永遠的噩夢——FROM簡述

終于，我們還是到了最后一個流程scope跳躍語句：FROM。

FROM指的到底是什么？為什么他的代碼我復制過來就失效了？這樣或那樣的問題中我們常常見到FROM的身影。FROM就是每個寫事件萌新的一大boss，引起了無數(shù)的bug，因此恐怕這一章我們還沒辦法做一個完整的介紹。

范例2-2 來擊個掌

還是讓我們把那個整天搞破壞的神經(jīng)病忘掉吧，沒人會喜歡那種mod的。

來擊個掌，如何？

規(guī)則很簡單，AI國家觸發(fā)事件后，隨機一個玩家國家會接收到一個消息“AI和你擊掌！”你有兩個選擇：接受或拒絕，如果接受，什么都不會發(fā)生；倘若拒絕......那個發(fā)起擊掌的AI國家就會滅亡。

這個功能包含三個事件，一個測試事件和AI方的測試事件放在下面，可以試試解讀一下......很簡單的。

想要測試事件，你只需要控制臺觸發(fā)xskiper_teach.202事件，便能隨機抽取一個幸運ai與你擊掌了。

如圖，在AI國家觸發(fā)的事件xskiper_teach.2020中，選取了一個隨機非ai國家（就是隨機玩家啦）觸發(fā)了一個新的事件，這個事件是這樣的：

這個事件只有三行是我們需要關注的：

FROM在這里首次出現(xiàn)了。

閱讀我們的事件要求，我們可以發(fā)現(xiàn)，在玩家國家觸發(fā)事件時，我們需要逆推到上個事件，找到上個事件的ROOT，從而可以對正確的目標進行滅國。

PREV只在一個事件內(nèi)部的scope轉換有效，這個時候我們就需要FROM。

在事件A觸發(fā)事件B的情況下，事件B中的FROM代表著事件A的ROOT。

同樣，FROM可以連續(xù)疊加，例如事件C中的FROMFROM在事件A觸發(fā)事件B，事件B觸發(fā)事件C的情況下，代表著事件A的ROOT。

這是FROM出現(xiàn)的第一種情況，也是最簡單的情況，但正如這個范例，這種FROM往往只在觸發(fā)國家切換轉變時不可替代，也就是國家關系，外交相關的那些事件。其他時候，萌新可以采用之后會介紹的event_target來避免其使用。

或許有萌新會在聽了之前的介紹依舊對FROM有點理解困難，不妨在游戲內(nèi)觸發(fā)事件時輸入debugtooltip的控制臺指令，鼠標放到事件的選項后，你可以看到事件的FROM和ROOT?？梢暂o助你的事件寫作。

相信這樣的技巧一定能夠幫助到各位modder。

FROM的功能絕不僅限于此，它對于剛進行event制作的modder的更大意義可能在于on_action提供的可調(diào)用scope上，關于這一點，我在下一篇會進行更詳盡的介紹。

四、流程scope跳躍語句：小結

流程scope跳躍語句和遍歷型有著很大的不同，它們指代的是一個獨立的目標而非一個模糊的群體。因此它們能夠成為那些，能夠在內(nèi)部指定額外目標的effect或condition語句中填寫的目標。同時，他們引用著我們之前所使用過的目標，一方面便于我們簡化流程，另一方面為我們進行一些更復雜的事件設計做好了鋪墊。

他們可以作為獨立的scope跳躍語句，也能夠作為目標填寫。其中的PREV和FROM可以通過堆疊進行跨越多層的引用。熟練運用ROOT和PREV是之后各位事件寫作的基本要求，所以請多練多學。

4 從前有艘船，船有所有者......——屬性scope跳躍語句

從前有艘船，船有所有者，所有者有首都，首都有星系，星系有星基......這樣的套娃可以無窮無盡，接下來我們接觸的一種scope跳躍語句，也是我們今天學習的最后一種scope跳躍語句，也就是屬性scope跳躍語句。

屬性scope跳躍語句，調(diào)用的是與THIS相關的其他scope，例如語句owner，調(diào)用的就是THIS的所有者，一個國家。同樣的還有語句ruler，調(diào)用的就是THIS國家scope的統(tǒng)治者。這樣的語句和遍歷型不同，和流程scope跳躍語句同樣只指代一個具體的目標。這些語句調(diào)用的是THIS的屬性，取得一個和THIS通過某些方式對應的scope。

其中有一些屬性scope跳躍語句是直接以scope類型來命名，不像owner之類淺顯易懂，比如這些：

在使用這種語句時一定要注意，只有當THIS對應的目標只有一個時，這樣的語句才會正常運作。比方說，對于一個國家，它有無數(shù)個pop，THIS為國家時，使用pop來跳躍scope顯然是錯誤的；而對于一個pop，他只在一個星球上，THIS種類為pop時使用planet來跳躍scope就是正確的。

同時這些scope語句也能作為目標填寫到那些需要填寫目標的effect或condition語句中。這一點和流程scope跳躍語句是類似的。

5 小結

終于寫完了......要吐了。

我們在本章學習了三種不同的常用scope跳躍語句：遍歷型scope跳躍語句、流程scope跳躍語句、屬性scope跳躍語句。運用這些語句我們可以輕松地找到各種各樣的目標。下面的練習題也將會側重于尋找目標的方法，希望各位對scope轉換能夠在參考習題后有了更深的理解。

再列舉一次吧……

• 遍歷型scope跳躍語句：搜索模糊的群體，批量處理大量符合條件的目標。

• 流程scope跳躍語句：指代獨立的個體，尋找在之前的事件代碼中已經(jīng)找到的目標。

• 屬性scope跳躍語句：指代獨立的個體，來源為當前scope，也就是THIS的屬性。

接下來讓我們回到上一章，也就是范例1-2，現(xiàn)在我們已經(jīng)有了自動遷移人口的能力了。讓我們再解析一下目前需要的目標。

范例2-3 爛大街的自動人口遷移（其二）

• 找到一個ROOT（觸發(fā)國家）擁有的，有空閑崗位的星球。

• 找到一個ROOT擁有的，沒有工作的pop。

• 將目標pop遷移到目標星球上。

?在熟悉掌握了流程scope跳躍語句后，我們可以這樣填寫：

當然這還不是人口自動遷移的全部，但作為一個基礎，它已經(jīng)有了足夠的功能......我們在（其三）見。

習題二

（1）請找到有這些功能的遍歷型scope跳躍語句，并嘗試指出其適用的THIS scope，以及指向的新scope的類型。

① 每一艘擁有的艦船；

② 銀河中的每一個物種；

③ 每一個接壤國家；

④ 恒星系內(nèi)的全部星球；

⑤ 軌道內(nèi)的全部艦隊。

（2）請指出下面幾段代碼中，注釋處THIS的scope類型。

（3）試著找到下面語句所描述的目標

① ROOT為國家，試著找到首都與ROOT首都星系距離小于20跳的國家。（首都capital_scope，查詢星系與星球/星系距離distance）;

② ROOT為星球，試著找到該星球星系內(nèi)的軍事艦隊的上將（星系solar_system，星系內(nèi)艦隊every_fleet_in_system，上將可以直接靠leader取到）；

③ ROOT為艦隊，試著找到艦隊所有者的全部爬行類人口（判斷種族小類：is_species_class）。

（4）試著寫出滿足下面要求的effect語句

① 令所有國家對與其關系低于-50的國家宣戰(zhàn)（判斷國家關系使用opinion）；

② 使我境內(nèi)的所有艦船歸我所有（設定所有權使用set_owner）；