OurCity3 玩家手册

本手册面向普通玩家、小镇成员、副镇长和镇长，介绍 OurCity3 的小镇、领地、经济与系统道具功能。

1. 阅读说明

OurCity3 的绝大多数功能都可以通过箱子菜单完成，文本指令则提供快捷入口或精确操作。

• /ourcity 可以简写为 /oc。
• /citychest 可以简写为 /cc。
• /tellcity <消息> 可以简写为 /tc <消息>。
• 指令中的 <参数> 必须填写，[参数] 可以省略。
• 玩家名称和小镇名称支持 Tab 自动补全。
• 菜单中的返回按钮位于左上角，关闭按钮位于右上角；需要翻页时，上一页和下一页分别位于左下角和右下角。
• 请勿尝试取走菜单中的功能物品。

插件内置简体中文、英语、日语和韩语，并会优先跟随玩家的 Minecraft 客户端语言。

2. 小镇身份与权限

2.1 身份说明

身份	说明
无小镇玩家	可以创建小镇、申请加入小镇，以及使用全服共享箱子和经济功能
白名单访客	不属于小镇成员，但可以绕过目标小镇的领地保护；不能进入目标小镇菜单或使用其小镇箱子
普通成员	正式小镇成员，可以使用成员功能和小镇共享箱子
副镇长	除普通成员功能外，还可以审批申请、移除普通成员、维护访客名单、编辑资料和管理小镇 Buff
镇长	小镇唯一所有者，可以执行全部小镇管理操作和解散小镇
黑名单访客	无法在目标小镇领地内执行受插件管理的操作，也不能申请加入该小镇

白名单只是领地保护的例外，不会让访客成为正式成员。领地保护开启后，普通成员、副镇长和镇长均按成员规则活动；身份差异主要决定小镇管理权限。

2.2 小镇管理权限

操作	默认最低身份
解散小镇	镇长
任命或撤销副镇长	镇长
审批加入申请	副镇长
移除成员	副镇长，只能操作比自己身份低的成员
编辑小镇简介和公告	副镇长
管理访客黑白名单	副镇长
管理小镇长期 Buff	副镇长

3. 快速开始

3.1 打开主菜单

在游戏内输入：

/ourcity

或使用简写：

/oc

服务器尚未建立小镇时，主菜单会显示空状态：

已建立的小镇从第二行开始排列。将光标移到小镇图标上，可以查看简介、镇长、成员数、中心点、等级和发展阶段；点击图标即可申请加入。

3.2 新玩家推荐流程

1. 输入 /oc 打开主菜单。
2. 创建一个小镇，或点击现有小镇图标提交加入申请。
3. 申请被镇长或副镇长同意后，你会成为普通成员。
4. 点击主菜单中的钟进入“我的小镇”，完成签到、查看成员和使用小镇功能。
5. 加入小镇后，可输入 /cc 直接打开小镇共享箱子。

3.3 小镇聊天

正式成员可以向当前在线的同镇成员发送消息：

/tellcity 今晚一起去挖矿
/tc 今晚一起去挖矿

发送者本人也会看到消息。白名单访客、待处理申请人、其他小镇玩家和离线成员不会收到；消息不会在成员下次登录时补发。单条消息最多 200 个 Unicode 字符。

4. 创建小镇

4.1 通过菜单创建

点击主菜单左上角的插件头像，依次填写：

1. 小镇名称。
2. 中心 X 坐标。
3. 中心 Z 坐标。
4. 确认创建。

默认规则如下：

• 小镇名称长度为 1 至 32 个字符，且不能与其他小镇重名。
• 小镇建立在服务器主世界，不读取玩家当前所在世界。
• 中心坐标由玩家输入，不强制使用当前位置。
• 初始等级和方形区域半径均为 1。
• 默认创建费用为 64 个钻石；服务器可能调整此费用。
• 玩家必须尚未加入其他小镇，创建位置也必须符合范围和预留空间规则。

也可以使用指令创建：

/ourcity town create <名称> <中心X> <中心Z>

4.2 区域与等级

小镇使用中心点和半径描述二维方形区域，不计算 Y 高度。等级始终等于主区域半径：

中心 X - 等级 ≤ X ≤ 中心 X + 等级
中心 Z - 等级 ≤ Z ≤ 中心 Z + 等级

因此，1 级小镇占用 3 × 3 个二维方块列。升级会让领地向四周扩张一圈，中心点保持不变。

5. 申请、加入与退出

5.1 提交和取消申请

在主菜单点击目标小镇图标，或输入：

/ourcity town join <小镇名称>

每名玩家同时只能保留一个待处理申请。申请尚未处理时，可点击主菜单中的取消申请按钮，或输入：

/ourcity town application cancel

如果已经加入小镇、已经申请其他小镇，或被目标小镇列入黑名单，将无法提交新申请。

5.2 审批申请

镇长和副镇长可以在小镇主页打开“加入申请”菜单：

• 左键点击申请人：同意申请。
• 右键点击申请人：拒绝申请。

也可以使用指令：

/ourcity town application accept <玩家名称>
/ourcity town application reject <玩家名称>

申请通过后，玩家会以普通成员身份加入小镇。

5.3 退出与成员管理

普通成员和副镇长可以从小镇主页退出，或输入：

/ourcity town leave

镇长不能直接退出自己的小镇。镇长和副镇长可以移除身份比自己低的成员：

/ourcity town member remove <玩家名称>

镇长可以任命或撤销副镇长：

/ourcity town member promote <玩家名称>
/ourcity town member demote <玩家名称>

6. 小镇主页

点击主菜单中的“我的小镇”进入小镇主页。

位置或图标	功能
返回按钮旁的告示牌	查看小镇信息；点击进入简介和公告编辑页
上方中间的钟	每日签到
左侧玩家头颅	成员列表
中间玩家头颅	加入申请列表
下方白色地毯	访客白名单
下方玩家头颅	全服玩家访客管理
下方黑色地毯	访客黑名单
左下角区域	领地保护与小镇长期 Buff
右下角箱子	小镇共享箱子
右下角屏障	退出小镇
退出按钮上方	解散小镇，仅镇长可以执行

6.1 简介和公告

点击小镇信息告示牌进入资料页面：

• 简介会展示在主菜单、小镇主页、进入领地提示和登录位置提示中。
• 公告只展示在小镇信息页面。
• 简介和公告最大长度均为 256 个字符。
• 输入 clear 可以清除内容，输入 cancel 可以取消本次菜单输入。

副镇长和镇长也可以使用指令：

/ourcity town description <简介|clear>
/ourcity town announcement <公告|clear>

6.2 成员列表

成员列表会展示玩家头像、身份、加入时间、最近签到日期和连续签到天数。

7. 签到、经验、等级与阶段

7.1 每日签到

小镇成员每天可以签到一次。默认每次签到为小镇增加 100 经验，并记录连续签到天数。签到成功会发送全服消息；同一天重复签到不会重复获得经验。

7.2 自动升级

小镇使用公共经验池。经验达到要求时会立即自动升级，多余经验会保留，并可能连续提升多个等级。由等级 r 升至 r + 1 的默认经验为：

8 × (r + 1) × 100

例如，1 级升到 2 级需要 1600 经验。小镇信息会以“当前经验/下一等级所需经验”显示进度。

经验来源包括：

• 成员每日签到。
• 成员在贡献商店出售物资。

7.3 发展阶段

等级	阶段	名称颜色	主菜单图标	新解锁长期 Buff
1–100	村	绿色	铁锭	生命恢复 I
101–300	镇	蓝色	金锭	急迫 I
301–600	城	紫色	绿宝石	速度 I
601–1000	都城	金色	钻石	抗性提升 I

7.4 小镇长期 Buff

长期 Buff 会随发展阶段逐步解锁，并由各小镇独立开关。默认需要副镇长或镇长身份才能切换。

长期 Buff 可以和玩家自行获得或从 Buff 商店购买的原版效果共存。已有更高等级效果时，较低等级的小镇效果不会将其覆盖。

8. 领地保护与访客名单

8.1 七类领地保护

保护	开启后的行为	默认开关管理身份
方块破坏	阻止外来玩家破坏方块	普通成员
方块放置	阻止外来玩家放置方块	普通成员
容器交互	阻止外来玩家打开真实容器	普通成员
实体交互	阻止外来玩家与实体右键交互	普通成员
PVP	在小镇范围内禁止玩家互相伤害	镇长
爆炸	防止爆炸破坏小镇方块；实体伤害与击退仍按原版处理	副镇长
燃烧	阻止点燃、火焰传播和方块烧毁	副镇长

“保护已开启”表示对应的保护规则正在生效，并不表示该行为已经开放。

8.2 白名单与黑名单

小镇主页底部提供三个访客管理入口：

1. 全服玩家列表：左键将玩家加入白名单，右键将玩家加入黑名单。
2. 白名单页面：查看白名单，点击玩家即可移除。
3. 黑名单页面：查看黑名单，点击玩家即可移除。

副镇长和镇长也可以使用指令：

/ourcity town visitor <whitelist|blacklist> <add|remove> <玩家名称>

白名单访客可以绕过七类保护，但不能使用小镇菜单、小镇箱子或成员管理功能。黑名单优先级最高，被列入黑名单的玩家无法在领地内进行受保护操作，也不能申请加入该小镇。

9. 共享箱子

9.1 全服共享箱子

全服共享箱子开放 54 个格子，入口位于主菜单关闭按钮旁。所有玩家看到并操作的是同一个箱子，放入的物品可能被其他玩家取走。

9.2 小镇共享箱子

每个小镇都有独立的共享箱子，只有正式成员可以使用。创建时默认解锁 9 个格子，此后每提升 20 级再解锁 1 格，最多 54 格。未解锁格子由灰色玻璃板占位，并显示所需等级。

快捷指令：

/citychest
/cc

没有加入小镇时，快捷指令会提示错误。

10. 经济中心与商店

从主菜单点击绿宝石进入经济中心。

经济中心提供个人银行、富豪榜、贡献商店、小卖铺和 Buff 商店。顶部金锭显示自己的账户余额；富豪榜显示当前服务器余额前 10 名。

10.1 贡献商店

贡献商店回收玩家背包中的指定物品，并同时给予账户货币和小镇经验。只有已经加入小镇的玩家才能出售。

• 点击商品本体：出售背包中的全部同类物品。
• 点击商品右侧三张纸：分别出售 1、16 或 64 个。
• 回收时只比较物品类型，附魔、耐久和其他 NBT 不会提高售价。
• 不同商品的价格与小镇经验收益可能不同。

10.2 小卖铺

小卖铺使用账户货币购买商品，并显示每份数量和剩余库存：

• 左键告示牌：购买 1 份。
• 右键告示牌：购买 64 份。

没有商品上架时，小卖铺会显示空状态：

商品会保留耐久、附魔、名称和其他完整物品数据，因此小卖铺中也可能出现特殊物品或系统道具。

10.3 Buff 商店

Buff 商店按分钟出售原版药水效果。商品图标会显示效果、等级和每分钟价格，右侧三张纸默认对应 10、30 和 60 分钟。

• 同等级效果会在剩余时间基础上累加。
• 更高等级商品会覆盖较低等级效果，并使用本次购买的持续时间。
• 已有更高等级或无限时长的同类效果时，系统会拒绝不合理购买且不会扣款。
• Buff 到期由 Minecraft 原版效果系统负责。

11. 个人银行与纸币

从经济中心点击末影箱，或输入 /ourcity bank，可以打开个人银行。

11.1 存款

点击“存入纸币”会将背包内全部有效的 OurCity3 纸币存入账户。普通纸张、改名纸张或仿造说明文字的物品不会被识别为纸币。

/ourcity bank deposit

11.2 取款

支持 1、50、100、1000 和 10000 五种面额。选择面额后：

• 左键取出 1 张。
• 右键取出 10 张。
• Shift 点击取出 64 张。

也可以使用指令：

/ourcity bank withdraw <1|50|100|1000|10000> <数量>

纸币可以交给其他玩家，也可能作为商品在小卖铺中出售。

11.3 转账与余额

菜单转账会依次要求输入收款玩家的完整名称和金额。成功后，付款方和在线收款方都会收到提示。

/ourcity bank balance
/ourcity bank transfer <玩家名称> <金额>

收款人可以离线，但必须曾经在服务器中形成玩家资料。离线转账会正常到账。

12. 玩家显示与位置提示

12.1 小镇和玩家颜色

• 已加入小镇的玩家会在头顶名称、聊天和 Tab 列表中显示 [小镇名称] 前缀。
• 未加入小镇的玩家会显示本地化的 [无小镇] 前缀。
• 小镇名称颜色由发展阶段决定。
• 玩家 ID 颜色和聊天正文颜色彼此独立。
• 很长的小镇名称在紧凑位置会保留首尾并缩略展示。

12.2 进入和离开领地

• 从野外进入小镇：聊天框显示小镇名称和简介，屏幕中央显示欢迎标题。
• 从小镇进入野外：聊天框显示离开小镇，不显示标题。
• 从小镇 A 直接进入小镇 B：只显示进入小镇 B 的提示。
• 通过下界门、末地门或其他方式传送后，系统也会重新判断所在位置。

12.3 加入服务器

登录后会显示欢迎标题和使用提示。如果登录位置位于小镇内，副标题与聊天信息还会显示当前位置及小镇简介。

12.4 系统消息中的互动信息

• 鼠标悬浮 <玩家名称>：查看玩家所属小镇、成员身份和消息时间；点击可在聊天输入框预填 /tell 玩家名称 。
• 鼠标悬浮 [小镇名称]：查看小镇的发展阶段、等级、镇长、成员数量和消息时间。
• 玩家或小镇资料失效时，悬浮信息会显示资料暂不可用，但不会影响原消息显示。

13. OurCity3 系统道具

系统道具带有插件专用标记，仅修改名称或说明文字不会改变其功能。

13.1 幻翼保护卡

将保护卡放在背包中，即可阻止幻翼攻击。触发保护时，幻翼会被传送到 Y=0 以下，保护卡不会因触发而消耗。

保护卡可能具有不同的死亡规则：一种会在玩家死亡时永久消失；另一种不会被插件删除，但仍遵循服务器正常的死亡掉落规则。请留意道具上的说明。

13.2 饥饿之斧

将饥饿之斧拿在主手或副手时，符合条件的玩家可以获得飞行能力。

• 公共版：任何玩家都可以使用。
• 绑定版：只有道具绑定的玩家可以使用。

13.3 随身末影箱

按 Q 丢出随身末影箱，即可打开自己的原版末影箱。普通丢出只用于触发，道具不会落地，也不会因使用而消耗；需要真正丢弃时，请先潜行再按 Q。

每名玩家打开的都是自己的末影箱，并非全服共享箱子或小镇共享箱子。

14. 玩家指令速查

14.1 小镇指令

指令	用途
/ourcity	打开小镇主菜单，可简写为 /oc
/ourcity town create <名称> <中心X> <中心Z>	创建小镇
/ourcity town join <小镇名称>	申请加入小镇
/ourcity town application cancel	取消自己的待处理申请
/ourcity town application accept <玩家名称>	同意加入申请
/ourcity town application reject <玩家名称>	拒绝加入申请
/ourcity town member remove <玩家名称>	移除身份较低的成员
/ourcity town member promote <玩家名称>	任命副镇长
/ourcity town member demote <玩家名称>	撤销副镇长
/ourcity town visitor <whitelist|blacklist> <add|remove> <玩家名称>	修改访客名单
/ourcity town description <简介|clear>	修改或清除简介
/ourcity town announcement <公告|clear>	修改或清除公告
/ourcity town leave	退出当前小镇
/ourcity town disband	解散当前小镇，仅镇长可用
/citychest	打开当前小镇共享箱子，可简写为 /cc
/tellcity <消息>	向在线的同镇正式成员发送消息，可简写为 /tc

14.2 银行指令

指令	用途
/ourcity bank	打开个人银行
/ourcity bank balance	查询账户余额
/ourcity bank deposit	存入背包中的全部有效纸币
/ourcity bank withdraw <面额> <数量>	从账户取出纸币
/ourcity bank transfer <玩家名称> <金额>	向已知玩家转账

15. 常见问题

15.1 为什么小卖铺是空的？

小卖铺可能暂时没有上架商品，请等待服务器运营方补充商品。

15.2 为什么我只能申请一个小镇？

每名玩家同时只能有一个待处理申请。请先在主菜单取消原申请，或等待原申请处理完毕，再申请其他小镇。

15.3 为什么开启保护后，成员仍然能放置方块？

领地保护用于阻止外来玩家。开关管理身份决定谁能修改规则，不限制正式成员正常放置、破坏或交互。

15.4 为什么改名后的纸张不能存款？

银行只识别由插件创建的有效纸币，物品名称和说明文字不作为鉴定依据。

15.5 为什么菜单在插件重载后被关闭？

重载前打开的菜单会自动关闭，以防旧菜单继续执行操作。重新输入 /oc 即可打开新菜单。