# 領地申請指南

> 本頁面目前只適用於 Ancient Server (1.12)。

本頁是關於 AlphaWorld 領地申請的相關規定與流程。**目前仍在編寫中，等文件寫完即開放申請，敬請期待。**

### 條約與聲明
本功能是為了讓創作型玩家能進行無負擔創作，且與生存模式分開，以不影響平衡性為初衷。以這初衷為前提明定下列條約與聲明：

1. 禁止將透過創造模式取得的物資，攜帶到其他世界使用。
2. 可在領地在建立生怪塔作為研究或觀摩，但禁止攜帶所得物資到其他世界使用。
3. 任何違反上面條例的玩家，管理群(OP/MOD)有權直接拔除該領地的擁有權限，且不還原申請額度。
4. 若是作為領地成員違反上面條例，除拔除成員身份外，也會將其申請額度扣除一單位。若再次被擁有者加入又犯，則連同擁有者一併拔除。
5. 由於是第一次開放旗幟功能給一般玩家使用，有使用情況難以評估。若發現有些旗幟會造成伺服器運算負擔，管理群有權再公告後將使用權直接收回。
6. 管理群(OP/MOD)雖有權限無視領地的保護機制，但仍不得對非其所擁有的領地的方塊與實體進行改動。

## 一、介紹

### 1-1. 申請
請直接到 Alpha 世界的王城，走入領地管理局，並依照 NPC 的指示進行申請。

{{:minecraft:領地申請_001.png?600|}}

＾ 圖 1-1-1：來到 Alpha 後，往重生點南方走，過了第一道城牆後，就會在東邊看到這棟建築物。

{{:minecraft:領地申請_002.png?600|}}

＾ 圖 1-1-2：門牌上以及警衛都會告訴你這裡是領地管理局。

{{:minecraft:領地申請_003.png?600|}}

＾ 圖 1-1-3：進去後，在一個樹叢邊看到 NPC，他說這裡是申請領地的入口。    

{{:minecraft:領地申請_004.png?600|}}

＾ 圖 1-1-4：進入地下室後，就看到一個廣大的空間，入口旁的 NPC 會跟你說明使用方式。

{{:minecraft:領地申請_006.png?300|}}
{{:minecraft:領地申請_007.png?300|}}

＾ 圖 1-1-5：其實這個系統就是世界的縮影。綠色的方格代表可以申請的領地。

{{:minecraft:領地申請_005.png?600|}}

＾ 圖 1-1-6：按下綠色方格上的按鈕，領地即申請完成。

### 1-2. 功能

在領地中，除了擁有者和成員外，其他不在成員名單的訪客，都無法對領地進行破壞。所以你可以安心的在領地進行創作，且不怕被破壞，也可以邀請朋友一起創作。透過下節指令可以查詢領地的資訊、並把朋友加入領地成員中。

領地系統另一個有趣的地方是可以針對自己的領地進行設定的客製化，包括預設的遊戲模式啦、生成的生物啦、是否能攻擊啦等等，都可以透過指令搭配第二章旗幟的清單進行設定唷。

### 1-3. 指令
^ 指令                                     | 別名       ^ 說明 ^
| `/region`                               | `/rg`    | 主指令 |
| `/rg info`                              |          | 查看當前所在領地的資訊 |
| `/rg info <領地代號>`                     |          | 查看指定領地的資訊 |
| `/rg addmember <領地代號> <玩家名稱>`      | `/rg am`  | 將指定玩家加為指定領地的成員 |
| `/rg removemember <領地代號> <玩家名稱>`   | `/rg rm`  | 將指定玩家從指定領地移除 |
| `/rg list -p <玩家名稱>`                  |          | 查看指定玩家所擁有的領地清單 |
| `/rg teleport <領地代號>`                 | `/rg tp`  | 傳送到指定領地 |
| `/rg flag <領地代號> <Flag名稱> <參數>`     |          | 修改指定領地的旗幟（Flag）屬性 |



## 二、旗幟（Flags）

本章節只列出一般玩家可設置的旗幟，所有旗幟請直接參照官方提供的參考文件。

### 2-1. 參數型別
每個旗幟的參數都有指定型別，參數的數值需要符合其型別。總共有七種型別，下面表格將一一條列，並舉例說明該如何填寫。

^ 指令         ^ 型別說明 ^
| `state`     | 狀態，`allow` 代表允許、`deny` 代表拒絕 |
| `string`    | 字串，例如：`hello, world` |
| `integer`   | 整數，例如：`5` |
| `double`    | 浮點數，例如：`5`, `5.5`, `2.425` |
| `location`  | 座標，例如：`0.5,64,1` 或 `here` |
| `boolean`   | 布林值，`true` 或 `false` |
| `set`       | 清單，透過逗號分隔，例如：`SPIDER, CREEPER` |

### 2-2. Override
^ 指令            ^ 參數型別 ^ 說明 ^
| `passthrough`  | state   | `deny` 時，該領地受保護，非成員只能行走，無其他權限。預設為 `deny`。 |

### 2-3. Protection-Related
^ 指令                ^ 參數型別 ^ 說明 ^
| `build`            | state  | 是否能建造，等同於 `block-break` 與 `block-place` |
| `block-break`      | state  | 是否能夠破壞方塊 |
| `block-place`      | state  | 是否能夠放置方塊 |
| `tnt`              | state  | 是否允許 tnt 爆炸 |
| `interact`         | state  | 是否允許玩家互動（等同於下列所有 Flags）|
| `use`              | state  | 是否允許玩家使用機關（門、按鈕、壓力板等） |
| `damage-anaimals`  | state  | 是·否允許玩家傷害動物 |
| `chest-access`     | state  | 是否允許玩家開啟箱子 |
| `ride`             | state  | 是否允許玩家乘坐載具（礦車、船、動物） |
| `pvp`              | state  | 是否允許玩家互鬥 |
| `sleep`            | state  | 是否允許玩家睡在床上 |
| `vehicle-place`    | state  | 是否允許玩家放置交通工具 |
| `vehicle-destroy`  | state  | 是否允許玩家摧毀交通工具 |
| `lighter`          | state  | 是否允許玩家使用打火石 |

### 2-4. Mobs, Fire, and Explosions
^ 指令                  ^ 參數型別 ^  說明 ^
| `creeper-explosion`  | state   | 苦力怕是否能造成破壞 |
| `ghast-fireball`     | state   | 地獄幽靈的火球是否能造成破壞 |
| `other-explosion`    | state   | 其他爆炸是否能造成破壞 |
| `fire-spread`        | state   | 火焰是否能延燒 |
| `enderman-grief`     | state   | EnderMan 是否能移動方塊 |
| `mob-damage`         | state   | 生物是否能傷害玩家 |
| `mob-spawning`       | state   | 是否會生成生物 |
| `deny-spawn`         | set     | 禁止指定生物生成 |
| `entity-painting-destroy`	     | state   | 非玩家的實體是否能破壞圖畫 |
| `entity-item-frame-destroy`    | state   | 非玩家的實體是否能破壞展示框 |

### 2-5. Natural Events
^ 指令                ^ 參數型別 ^ 說明 ^
| `lava-fire`        | state   | 岩漿是否能延燒出火焰 |
| `lightning`        | state   | 閃電是否有攻擊性 |
| `snow-fall`        | state   | 會不會下雪 |
| `snow-melt`        | state   | 雪會不會融化 |
| `ice-form`         | state   | 水會不會結冰 |
| `ice-melt`         | state   | 冰會不會融化 |
| `mushroom-growth`  | state   | 香菇會不會生長 |
| `leaf-decay`       | state   | 樹葉會不會腐爛 |
| `grass-growth`     | state   | 草地會不會能蔓延 |
| `mycelium-spread`  | state   | 菌絲土會不會蔓延|
| `vine-growth`      | state   | 藤蔓會不會生長 |

### 2-6. Map Making
^ 指令            ^ 參數型別   ^ 說明 ^
| `item-pickup`  | string   | 是否能撿拾物品 |
| `item-drop`    | string   | 是否能丟棄物品 |
| `greeting`     | string   | 進入領地的問候語 |
| `farewell`     | string   | 離開領地的問候語 |
| `enderpearl`   | string   | 是否能使用終界珍珠 |
| `game-mode`    | string   | 遊戲模式：`survival`、`creative`、`adventure`|
| `teleport`     | location | 透過 `/rg tp <領地代號>` 傳送的目的地 |
| `spawn`        | location | 透過 `/rg tp -s <領地代號>` 傳送的目的地 |

### 2-7. Miscellaneous
^ 指令          ^ 參數型別 ^ 說明 ^
| `pistons`    | state   | 是否能使用活塞 |

### 2-8. Extra Flags (尚未開放)
^ 指令            ^ 參數型別   ^ 說明 ^
| `teleport-on-entry` | location | If player enter region given by this flag they are teleported to location provided.
| `teleport-on-exit`  | location | If player exit region given by this flag they are teleported to location provided.
| `command-on-entry`  | string   | If player enter or exit region command(s) are ran by player with OP (Use %username% for player username placeholder)! |
| `command-on-exit`   | string   | If player enter or exit region command(s) are ran by player with OP (Use %username% for player username placeholder)! | 
| `walk-speed`        | double   | Sets speed how fast player runs |
| `keep-inventory`    | state    | Can player keep their items on death? |
| `keep-exp`          | state    | Can player keep their exp on death? |
| `chat-prefix`       | string   | Add chat prefix inside region |
| `chat-suffix`       | string   | Add chat suffix inside region |
| `godmode`           | godmode  | Allow / deny taking damage inside region |
| `blocked-effects`   | ?        | Block effects inside region |
| `respawn-location`  | location | Changes player respawn location if they are inside region |
| `worldedit`         | state    | Allow or deny worldedit inside region |
| `give-effects`      | ?        | Give effect while inside region, restores old effects on region leave with correct time left and if potion consumed while under effect it will be given correctly on leave |
| `fly`               | state    | Allow flying inside a region |
| `play-sounds`       | ?        | Allows you to play sounds once or repeatly, on 1.9 and above the sounds stop playing as soon as you leave the region, on 1.8 you have to | wait the sound ends |
| `frostwalker`       | state    | Deny frostwalker inside region |
| `nether-portals`    | state    | Block creation of nether portals |
| `allow-block-place` | set      | Allows placing specified block(s) overriding region permissions |
| `deny-block-place`  | set      | Blocks placing specified block(s) even with permissions to region |
| `allow-block-break` | set      | Allows breaking specified block(s) overriding region permissions |
| `deny-block-break`  | set      | Blocks breaking specified block(s) even with permisisons to region |
| `glide`             | ?        | Block elytra or force them to have elytra effect without having elytra equipped and works even if the player is on ground |
| `chunk-unload`      | state    | Block chunks unloading inside the region |
| `item-durability`   | state    | Block item damage inside the region |

### 2-9 領地預設的旗幟資訊：

```
ehicle-place: ALLOW
interact: ALLOW
tnt: DENY
vehicle-destroy: ALLOW
other-explosion: DENY
fire-spread: DENY
deny-spawn: [ZOMBIE_VILLAGER, ENDERMAN, ZOMBIE, CAVE_SPIDER, PIG_ZOMBIE, WITCH, SILVERFISH, CREEPER, SKELETON, SPIDER]
creeper-explosion: DENY
```