OurCity3 玩家手册
OurCity3 玩家手册
本手册面向普通玩家、小镇成员、副镇长和镇长，介绍 OurCity3 的小镇、领地、经济与系统道具功能。
1. 阅读说明
OurCity3 的绝大多数功能都可以通过箱子菜单完成，文本指令则提供快捷入口或精确操作。
/ourcity可以简写为/oc。/citychest可以简写为/cc。/tellcity <消息>可以简写为/tc <消息>。- 指令中的
<参数>必须填写，[参数]可以省略。 - 玩家名称和小镇名称支持 Tab 自动补全。
- 菜单中的返回按钮位于左上角，关闭按钮位于右上角；需要翻页时，上一页和下一页分别位于左下角和右下角。
- 请勿尝试取走菜单中的功能物品。
插件内置简体中文、英语、日语和韩语，并会优先跟随玩家的 Minecraft 客户端语言。
2. 小镇身份与权限
2.1 身份说明
| 身份 | 说明 |
|---|---|
| 无小镇玩家 | 可以创建小镇、申请加入小镇，以及使用全服共享箱子和经济功能 |
| 白名单访客 | 不属于小镇成员，但可以绕过目标小镇的领地保护；不能进入目标小镇菜单或使用其小镇箱子 |
| 普通成员 | 正式小镇成员，可以使用成员功能和小镇共享箱子 |
| 副镇长 | 除普通成员功能外，还可以审批申请、移除普通成员、维护访客名单、编辑资料和管理小镇 Buff |
| 镇长 | 小镇唯一所有者，可以执行全部小镇管理操作和解散小镇 |
| 黑名单访客 | 无法在目标小镇领地内执行受插件管理的操作，也不能申请加入该小镇 |
白名单只是领地保护的例外，不会让访客成为正式成员。领地保护开启后，普通成员、副镇长和镇长均按成员规则活动；身份差异主要决定小镇管理权限。
2.2 小镇管理权限
| 操作 | 默认最低身份 |
|---|---|
| 解散小镇 | 镇长 |
| 任命或撤销副镇长 | 镇长 |
| 审批加入申请 | 副镇长 |
| 移除成员 | 副镇长，只能操作比自己身份低的成员 |
| 编辑小镇简介和公告 | 副镇长 |
| 管理访客黑白名单 | 副镇长 |
| 管理小镇长期 Buff | 副镇长 |
3. 快速开始
3.1 打开主菜单
在游戏内输入：
1 | |
或使用简写：
1 | |
服务器尚未建立小镇时，主菜单会显示空状态：
已建立的小镇从第二行开始排列。将光标移到小镇图标上，可以查看简介、镇长、成员数、中心点、等级和发展阶段；点击图标即可申请加入。
3.2 新玩家推荐流程
- 输入
/oc打开主菜单。 - 创建一个小镇，或点击现有小镇图标提交加入申请。
- 申请被镇长或副镇长同意后，你会成为普通成员。
- 点击主菜单中的钟进入“我的小镇”，完成签到、查看成员和使用小镇功能。
- 加入小镇后，可输入
/cc直接打开小镇共享箱子。
3.3 小镇聊天
正式成员可以向当前在线的同镇成员发送消息：
1 | |
发送者本人也会看到消息。白名单访客、待处理申请人、其他小镇玩家和离线成员不会收到；消息不会在成员下次登录时补发。单条消息最多 200 个 Unicode 字符。
4. 创建小镇
4.1 通过菜单创建
点击主菜单左上角的插件头像，依次填写：
- 小镇名称。
- 中心 X 坐标。
- 中心 Z 坐标。
- 确认创建。
默认规则如下：
- 小镇名称长度为 1 至 32 个字符，且不能与其他小镇重名。
- 小镇建立在服务器主世界，不读取玩家当前所在世界。
- 中心坐标由玩家输入，不强制使用当前位置。
- 初始等级和方形区域半径均为 1。
- 默认创建费用为 64 个钻石；服务器可能调整此费用。
- 玩家必须尚未加入其他小镇，创建位置也必须符合范围和预留空间规则。
也可以使用指令创建：
1 | |
4.2 区域与等级
小镇使用中心点和半径描述二维方形区域，不计算 Y 高度。等级始终等于主区域半径：
1 | |
因此，1 级小镇占用 3 × 3 个二维方块列。升级会让领地向四周扩张一圈，中心点保持不变。
5. 申请、加入与退出
5.1 提交和取消申请
在主菜单点击目标小镇图标，或输入：
1 | |
每名玩家同时只能保留一个待处理申请。申请尚未处理时，可点击主菜单中的取消申请按钮，或输入：
1 | |
如果已经加入小镇、已经申请其他小镇，或被目标小镇列入黑名单，将无法提交新申请。
5.2 审批申请
镇长和副镇长可以在小镇主页打开“加入申请”菜单：
- 左键点击申请人：同意申请。
- 右键点击申请人：拒绝申请。
也可以使用指令：
1 | |
申请通过后，玩家会以普通成员身份加入小镇。
5.3 退出与成员管理
普通成员和副镇长可以从小镇主页退出，或输入：
1 | |
镇长不能直接退出自己的小镇。镇长和副镇长可以移除身份比自己低的成员：
1 | |
镇长可以任命或撤销副镇长：
1 | |
6. 小镇主页
点击主菜单中的“我的小镇”进入小镇主页。
| 位置或图标 | 功能 |
|---|---|
| 返回按钮旁的告示牌 | 查看小镇信息；点击进入简介和公告编辑页 |
| 上方中间的钟 | 每日签到 |
| 左侧玩家头颅 | 成员列表 |
| 中间玩家头颅 | 加入申请列表 |
| 下方白色地毯 | 访客白名单 |
| 下方玩家头颅 | 全服玩家访客管理 |
| 下方黑色地毯 | 访客黑名单 |
| 左下角区域 | 领地保护与小镇长期 Buff |
| 右下角箱子 | 小镇共享箱子 |
| 右下角屏障 | 退出小镇 |
| 退出按钮上方 | 解散小镇，仅镇长可以执行 |
6.1 简介和公告
点击小镇信息告示牌进入资料页面：
- 简介会展示在主菜单、小镇主页、进入领地提示和登录位置提示中。
- 公告只展示在小镇信息页面。
- 简介和公告最大长度均为 256 个字符。
- 输入
clear可以清除内容，输入cancel可以取消本次菜单输入。
副镇长和镇长也可以使用指令：
1 | |
6.2 成员列表
成员列表会展示玩家头像、身份、加入时间、最近签到日期和连续签到天数。
7. 签到、经验、等级与阶段
7.1 每日签到
小镇成员每天可以签到一次。默认每次签到为小镇增加 100 经验，并记录连续签到天数。签到成功会发送全服消息；同一天重复签到不会重复获得经验。
7.2 自动升级
小镇使用公共经验池。经验达到要求时会立即自动升级，多余经验会保留，并可能连续提升多个等级。由等级 r 升至 r + 1 的默认经验为：
1 | |
例如，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 | |
白名单访客可以绕过七类保护，但不能使用小镇菜单、小镇箱子或成员管理功能。黑名单优先级最高，被列入黑名单的玩家无法在领地内进行受保护操作，也不能申请加入该小镇。
9. 共享箱子
9.1 全服共享箱子
全服共享箱子开放 54 个格子，入口位于主菜单关闭按钮旁。所有玩家看到并操作的是同一个箱子，放入的物品可能被其他玩家取走。
9.2 小镇共享箱子
每个小镇都有独立的共享箱子，只有正式成员可以使用。创建时默认解锁 9 个格子，此后每提升 20 级再解锁 1 格，最多 54 格。未解锁格子由灰色玻璃板占位，并显示所需等级。
快捷指令：
1 | |
没有加入小镇时，快捷指令会提示错误。
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 纸币存入账户。普通纸张、改名纸张或仿造说明文字的物品不会被识别为纸币。
1 | |
11.2 取款
支持 1、50、100、1000 和 10000 五种面额。选择面额后：
- 左键取出 1 张。
- 右键取出 10 张。
- Shift 点击取出 64 张。
也可以使用指令：
1 | |
纸币可以交给其他玩家，也可能作为商品在小卖铺中出售。
11.3 转账与余额
菜单转账会依次要求输入收款玩家的完整名称和金额。成功后，付款方和在线收款方都会收到提示。
1 | |
收款人可以离线，但必须曾经在服务器中形成玩家资料。离线转账会正常到账。
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 即可打开新菜单。