星铸要典

Starforged Essentials

Starforged Essentials 是一款轻量级实用模组，为 Hytale 添加了核心的便捷命令和服务器工具。它被设计为一个简单、可靠的基础，适用于任何世界或服务器，提供了玩家所期待的基本功能，同时保持快速、干净和不显眼。

拥有家、传送、权限等功能，Starforged Essentials 给予玩家所需的便利，同时不改变核心游戏体验。

功能：

• /home & /sethome — 玩家可以保存并返回个人位置。
• /tpa & /tpaccept — 玩家间的传送请求，用于合作游玩。
• 权限支持 — 控制谁能使用哪些命令。
• 轻量级实用工具 — 额外的小功能以改善日常游戏体验。
• 服务器友好 — 简单、稳定，旨在任何模组包中流畅运行。

非常适合生存服务器、社区世界，或任何想要一个干净、无多余功能的必备系统的玩家。

================================================================================                               1. 家系统

命令：   /sethome              - 将当前位置设为默认家   /sethome <名称>       - 将当前位置设为命名的家   /home                 - 传送到默认家   /home <名称>          - 传送到命名的家   /delhome <名称>       - 删除命名的家   /homes                - 列出你的所有家

权限：   starforge.sethome     - 可以设置家   starforge.home        - 可以传送到家   starforge.delhome     - 可以删除家   starforge.listhomes   - 可以列出家

配置选项：   - max-homes: 允许的最大家数量（-1 = 无限）   - teleport-cooldown: 传送间的冷却时间   - movement-cancel: 移动是否取消传送预热

================================================================================                               2. 地标系统

命令：   /setwarp <名称>       - 在当前位置创建一个地标   /warp <名称>          - 传送到命名的地标   /delwarp <名称>       - 删除命名的地标

权限：   starforge.setwarp     - 可以创建地标   starforge.warp        - 可以使用地标   starforge.delwarp     - 可以删除地标

配置选项：   - max-warps: 允许的最大地标数量（-1 = 无限）

================================================================================                              3. 消息系统

命令：   /msg <玩家> <消息>   - 发送私密消息   /m <玩家> <消息>     - /msg 的别名   /message <玩家> <消息>   - /msg 的别名   /whisper <玩家> <消息>   - /msg 的别名   /tell <玩家> <消息>      - /msg 的别名   /pm <玩家> <消息>        - /msg 的别名   /dm <玩家> <消息>        - /msg 的别名   /r <消息>              - 回复最后发送消息的人

权限：   starforge.message     - 可以发送私密消息   starforge.reply       - 可以回复消息

配置选项：   - prefix-color: /msg 前缀的颜色（默认: &9 蓝色）

================================================================================                               4. 返回系统

命令：   /back                 - 传送到上次死亡/传送的位置

权限：   starforge.back        - 可以使用 /back 命令

配置选项：   - max-back-locations: 追踪多少个位置   - cooldown.enabled: 启用/禁用冷却   - cooldown.seconds: 冷却时间（-1 = 无冷却）

================================================================================                           5. 随机传送

命令：   /rtp                  - 传送到随机安全位置

权限：   starforge.rtp         - 可以使用随机传送

配置选项：   - max-distance: 距离出生点的最大距离   - min-distance: 距离出生点的最小距离   - cooldown.seconds: 使用间隔冷却时间（-1 = 无冷却）   - safety options: 地面检查、熔岩检查、掉落伤害检查

安全特性：   - 确保玩家在地面之上   - 避免熔岩   - 防止从高处坠落伤害

================================================================================                               6. TPA 系统

命令：   /tpa <玩家>         - 请求传送到玩家身边   /tpahere <玩家>     - 请求玩家传送至你身边   /tpaccept             - 接受传入的 TPA 请求   /tpdeny               - 拒绝传入的 TPA 请求   /tpaauto              - 切换 TPA 自动接受（不包括 TPAHere）   /tpablock <玩家>    - 屏蔽来自某玩家的 TPA 请求   /tpaunblock <玩家>  - 取消屏蔽来自某玩家的 TPA 请求

权限：   starforge.tpa         - 可以发送 TPA 请求   starforge.tpahere     - 可以发送 TPAHere 请求   starforge.tpaccept    - 可以接受 TPA 请求   starforge.tpadeny     - 可以拒绝 TPA 请求   starforge.tpaauto     - 可以切换自动接受   starforge.tpablock    - 可以屏蔽玩家   starforge.tpaunblock  - 可以取消屏蔽玩家

配置选项：   - request-timeout: 请求过期前的秒数   - cooldown.tpa-seconds: /tpa 的冷却时间   - cooldown.tpahere-seconds: /tpahere 的冷却时间

================================================================================                               7. 出生点系统

命令：   /spawn                - 传送到出生点   /setspawn             - 设置出生点位置

权限：   starforge.spawn       - 可以传送到出生点   starforge.setspawn    - 可以设置出生点位置

配置选项：   - spawn-protection.enabled: 启用出生点保护   - spawn-protection.duration-seconds: 保护持续时间（默认: 5）   - spawn-protection.cancel-on-attack: 玩家攻击时结束保护

================================================================================                              经济命令

/bal 或 /money      - 用于查看你的余额 /pay 玩家名       - 向玩家发送指定金额 /baltop          - 显示最富有的前10名玩家及其金额

================================================================================                              工具包命令

/kits               - 显示所有当前可用的工具包 /kit 名称      - 用于领取该工具包

================================================================================                              8. 管理员命令

上帝模式：   /god                  - 切换自身上帝模式   /god <玩家>         - 切换目标玩家上帝模式   权限: starforge.admingod   注意: 退出登录后关闭

治疗：   /heal                 - 治疗自身（满血/满体力，移除减益效果）   /heal <玩家>        - 治疗目标玩家   权限: starforge.adminheal

飞行：   /fly                  - 切换自身飞行模式   /fly <玩家>         - 切换目标玩家飞行模式   /flyspeed <速度>     - 设置自身飞行速度   /flyspeed <玩家> <速度> - 设置目标玩家飞行速度   权限: starforge.adminfly   注意: 退出登录后关闭

到顶：   /top                  - 传送到头顶最高方块   权限: starforge.admintop

清空背包：   /clearinventory       - 清空自身背包   /clearinventory <玩家> - 清空目标玩家背包   权限: starforge.adminclearinventory

公告：   /broadcast <消息>  - 向所有玩家发送带颜色消息   权限: starforge.adminbroadcast

睡眠：   /sleep <百分比>   - 设置跳过夜晚所需睡眠百分比（例如 /sleep 5 = 5%）   权限: starforge.adminsleep

重载：   /reload               - 重载所有配置文件、权限和玩家数据   权限: starforge.adminreload

别名管理：   /alias add "<命令>" <别名> - 添加命令别名（支持多词命令）                                   示例：                                     /alias add "fly" f                                     /alias add "gamemode creative" gmc                                     /alias add "gamemode adventure" gma   /alias rem <别名>            - 移除命令别名（例如 /alias rem f）   /alias list                   - 列出所有别名   权限: starforge.adminalias   注意: 别名保存到 alias.yml 配置文件中

禁言：   /mute <玩家> [时长] [原因...] - 禁言玩家（支持可选时长）                                           时长格式: 5s, 10m, 2h, 1d 或直接写秒数（30）   /unmute <玩家>      - 解除玩家禁言   权限: starforge.adminmute

封禁：   /ban <玩家> [时长] [原因...]  - 封禁玩家（支持可选时长）                                           时长格式: 5s, 10m, 2h, 1d 或直接写秒数（30）                                           时长可以是第一个或最后一个参数：                                             /ban Novaelix 5s griefing                                             /ban Novaelix griefing 5s   /unban <玩家>       - 解封玩家   权限: starforge.adminban

踢出：   /kick <玩家> <原因> - 踢出玩家并附上原因   权限: starforge.adminkick

冻结：   /freeze <玩家>      - 冻结/解冻玩家（阻止移动和传送）   权限: starforge.freeze

修复：   /repair               - 修复背包中的所有物品   /repair <玩家>      - 修复另一名玩家的背包   权限: starforge.repair   额外权限: starforge.repair.others（修复其他玩家时需要）

游戏模式：   /gamemode <adventure|creative> [玩家] - 设置游戏模式   权限: starforge.admingamemode

时间：   /time set <day|night> - 设置时间   权限: starforge.admintime

天气：   /weather set <clear|rain|snow> - 设置天气   权限: starforge.adminweather

传送所有玩家至此：   /tpallhere            - 将所有玩家传送至你身边   权限: starforge.admintpallhere

击杀：   /kill <玩家>        - 击杀一名玩家   权限: starforge.adminkill

等级管理：   /promote <玩家>     - 将玩家的等级提升 +1（不能提升至 >= 你的等级）   /demote <玩家>      - 将玩家的等级降低 -1（不能降低至高于你的等级 / 低于最低等级）   权限: starforge.adminpromote, starforge.admindemote

传送（管理员）：   /tp <玩家>          - 传送到玩家身边

白名单维护模式： /maintenance on      - 启用白名单 /maintenance off      - 禁用白名单

经济管理： /bal set 玩家名 金额       - 将玩家余额设置为指定金额 /bal add 玩家名 金额       - 为玩家增加指定金额 /bal rem 玩家名 金额       - 从玩家余额中移除指定金额

================================================================================                           10. 配置文件

四个配置文件：   1. config.yml      - 主插件配置   2. permissions.yml - 等级和权限定义   3. alias.yml       - 命令别名（自动生成）   4. players.yml     - 玩家数据（自动生成）

config.yml 部分：   - motd: 每日消息（支持颜色代码 & URL）   - rules: 服务器规则（多行，支持颜色代码）   - join-message: 加入/首次加入消息   - spawn-protection: 无敌设置   - homes: 家数量限制和冷却   - warps: 地标数量限制   - messaging: 私密消息格式   - back: 返回命令设置   - rtp: 随机传送设置   - tpa: TPA 请求设置   - enabled-commands: 启用命令列表   - disabled-commands: 禁用命令列表（仅 OP）   - permission-system.use-builtin: true/false   - 基于等级的白名单选项，白名单踢出消息，以及启用：true/false

permissions.yml 结构：   default-rank: "member"   ranks:     member:       prefix: "&7[Member] "       permissions:         - starforge.home         - starforge.sethome         - starforge.rtp         - starforge.tpahere         - starforge.admins         - （等等...）     vip:       prefix: "&a[VIP] "       inherit: member    # 继承所有 member 权限       permissions: []    # 暂时为空 - 在此处添加未来的 VIP 特权     admin:       prefix: "&c[Admin] "       inherit: vip       # 继承所有 VIP 权限       permissions:         - starforge.admingod         - （等等...）

players.yml 结构：   players:     "uuid-here":       username: "PlayerName"       rank: "member"       nickname: ""       # 支持颜色代码: "&6Cool&eNick"       first-join: "2025-01-19T12:00:00"       last-seen: "2025-01-19T15:30:00"

alias.yml 结构：   aliases:     f: "fly"     h: "heal"     # 格式: 别名: "命令"

日志文件（自动创建）：   - mute-log.txt  - 所有禁言/解除禁言记录，含时间戳   - ban-log.txt   - 所有封禁/解封记录，含时间戳和 IP   - kick-log.txt  - 所有踢出记录，含时间戳

================================================================================                             11. 权限列表

玩家权限：   starforge.sethome          - 设置家位置   starforge.home             - 传送到家   starforge.delhome          - 删除家   starforge.listhomes        - 列出所有家   starforge.warp             - 使用地标   starforge.message          - 发送私密消息   starforge.reply            - 回复消息   starforge.back             - 返回最后位置   starforge.rtp              - 随机传送   starforge.tpa              - 请求传送到玩家   starforge.tpaccept         - 接受 TPA 请求   starforge.tpadeny          - 拒绝 TPA 请求   starforge.tpaauto          - 切换自动接受   starforge.tpablock         - 屏蔽来自玩家的 TPA   starforge.tpaunblock       - 取消屏蔽来自玩家的 TPA   starforge.tpahere          - 请求玩家传送至你   starforge.spawn            - 传送到出生点   starforge.help             - 查看帮助   starforge.list             - 查看在线玩家   starforge.nickname         - 设置/移除昵称   starforge.admins           - 查看在线管理员（信息性）   starforge.balance       - 用于 balance/money 命令   starforge.balancetop       - 用于 /baltop 命令   starforge.pay       - 用于 /pay 命令   starforge.kit        - 用于 /kit 和 /kits 命令

管理员权限：   starforge.setwarp          - 创建地标   starforge.delwarp          - 删除地标   starforge.setspawn         - 设置出生点位置   starforge.admingod         - 上帝模式   starforge.adminheal        - 治疗命令   starforge.adminfly         - 飞行模式 & 速度   starforge.admintop         - 传送到顶   starforge.adminclearinventory - 清空背包   starforge.adminbroadcast   - 公告消息   starforge.adminsleep       - 设置睡眠百分比   starforge.adminreload      - 重载配置   starforge.adminmute        - 禁言/解除禁言玩家   starforge.adminban         - 封禁/解封玩家   starforge.adminkick        - 踢出玩家   starforge.admintp          - 管理员传送   starforge.freeze           - 冻结/解冻玩家   starforge.adminkill        - 击杀玩家   starforge.admintime        - 设置时间   starforge.adminweather     - 设置天气   starforge.admingamemode    - 更改游戏模式   starforge.repair           - 修复物品   starforge.repair.others    - 修复其他玩家的物品   starforge.adminpromote     - 提升玩家等级   starforge.admindemote      - 降低玩家等级   starforge.adminalias       - 管理命令别名   starforge.adminmaintenance      - 启用/禁用白名单模式   starforge.adminbal           - 用于设置、增加和减少玩家余额

================================================================================                               12. 颜色代码

颜色：   &0 - 黑色           &8 - 深灰色   &1 - 深蓝色       &9 - 蓝色   &2 - 深绿色      &a - 绿色   &3 - 深青色       &b - 青色   &4 - 深红色        &c - 红色   &5 - 深紫色     &d - 浅紫色   &6 - 金色            &e - 黄色   &7 - 灰色            &f - 白色

格式：   &l - 粗体   &o - 斜体   &n - 下划线   &m - 删除线   &k - 随机字符   &r - 重置

示例：   "&6Welcome &eto the server!"  = 金色 "Welcome " + 黄色 "to the server!"   "&c&lWARNING"                 = 红色加粗 "WARNING"   "&a[VIP] &fPlayerName"        = 绿色 "[VIP] " + 白色 "PlayerName"