Civillis Regions

Civillis Regions 是一个 Civillis 附属模组。
Civillis Regions is an addon for Civillis.

支持版本：Forge 1.20.1、NeoForge 1.21.1。
Supported builds: Forge 1.20.1 and NeoForge 1.21.1.

它允许服务器管理员创建自定义区块区域，在区域内创建 3D 子区域，配置 Civillis 风格的进入/离开 HUD 提示，并可选地在 FTB Chunks 地图上显示区域叠加层。
It lets server admins define custom chunk-based regions, create 3D sub-regions inside them, configure Civillis-style enter/leave HUD notices, and optionally show region overlays on FTB Chunks maps.

Features / 功能

• 创建父级自定义区域，使用两个方块坐标框选。
  Create custom parent regions using two block positions.

• 父级区域只保存区块 X/Z 范围，忽略 Y 高度。
  Parent regions store chunk X/Z ranges only; Y height is ignored.

• 可在父级区域内创建子区域。
  Create sub-regions inside parent regions.

• 子区域按完整 X/Y/Z 方块盒判断范围。
  Sub-regions use full X/Y/Z block-box checks.

• 区域按维度区分。
  Regions are dimension-specific.

• 自定义进入/离开 HUD 文本。
  Configure custom enter and leave HUD messages.

• 可选设置进入/离开提示颜色。
  Optional enter/leave message colors.

• 服务端可配置 HUD 提示大小。
  Server-configurable HUD notice scale.

• Civillis 风格淡入淡出动画和侧边条。
  Civillis-style fade animation and side bars.

• 与原版 Civillis HUD 共存。
  Works alongside the original Civillis HUD.

• 可选 FTB Chunks 大地图和小地图叠加层。
  Optional FTB Chunks large map and minimap overlays.

• 支持显示自定义父级区域和 Civillis 文明区域。
  Supports overlays for custom parent regions and Civillis civilization regions.

• 子区域不会显示在 FTB Chunks 叠加层上。
  Sub-regions do not render on FTB Chunks overlays.

• 大地图鼠标悬停显示区域名称。
  Large map labels appear only when hovering over regions.

• 可配置叠加层颜色、显示字样、填充透明度和边框透明度。
  Configurable overlay colors, labels, fill alpha, and border alpha.

• FTB Chunks 原版 claimed chunks 的显示优先级高于本模组叠加层。
  Native FTB Chunks claimed chunks keep visual priority over this addon overlay.

• 区域数据持久保存到世界。
  Region data is saved persistently in the world.

• 管理指令统一在 /civil 下。
  Admin commands are available under /civil.

Commands / 指令

/civil create <id> <pos1> <pos2>
/civil resize <id> <pos1> <pos2>
/civil edit <id> "<enter text>" "<leave text>" [RRGGBB] [RRGGBB]
/civil overlay <id> "<display name>" [RRGGBB]
/civil sub create <parentId> <id> <pos1> <pos2>
/civil sub edit <parentId> <id> "<enter text>" "<leave text>" [RRGGBB] [RRGGBB]
/civil sub resize <parentId> <id> <pos1> <pos2>
/civil sub list [parentId]
/civil sub delete <parentId> <id>
/civil hudscale [scale]
/civil list
/civil delete <id>

颜色参数支持 RRGGBB 或 #RRGGBB，但命令里建议使用不带 # 的 RRGGBB 写法。
Color arguments accept RRGGBB or #RRGGBB, but commands should usually use RRGGBB because # can be treated specially by command input.

FTB Chunks Overlay / FTB Chunks 叠加层

安装 FTB Chunks 后，本模组可以在大地图和小地图上绘制可选叠加层。
When FTB Chunks is installed, this addon can draw optional overlays on the large map and minimap.

叠加层默认关闭，需要在客户端配置里手动开启。
Overlays are disabled by default and must be enabled in client config.

会显示：
Displayed overlays:

• 本模组创建的自定义父级区域。
  Custom parent regions created by this addon.

• Civillis 文明区域。
  Civillis civilization regions.

不会显示：
Not displayed:

• 子区域。
  Sub-regions.

• 荒野。
  Wilderness.

• 未知区域。
  Unknown areas.

• 低/中等级 band。
  Low / medium bands.

• Monster band。
  Monster band.

地图文字只会在大地图鼠标悬停时显示。正常地图和小地图只显示色块与边框。
Map text appears only when hovering on the large map. Normal map and minimap rendering only shows fills and borders.

Compatibility / 兼容性

Forge 1.20.1 版本需要 Civillis 1.3.2+。
The Forge 1.20.1 build requires Civillis 1.3.2+.

NeoForge 1.21.1 版本需要 Civillis 1.3.2+。
The NeoForge 1.21.1 build requires Civillis 1.3.2+.

FTB Chunks 是可选依赖；未安装时，自定义区域和子区域 HUD 提示仍可正常使用。
FTB Chunks is optional. Without it, custom region and sub-region HUD notices still work.