USF 使用指南

下面介绍 USF 框架插件的具体使用方法。所有操作都在游戏内完成，无需修改文件，通过命令、物品、界面进行。

1. 在聊天栏输入 /function get_owner 获取超级管理员权限

2. 或在服务器后台输入 /scriptevent usf:get_owner 玩家名

3. 单人存档和服务器的 OP 权限不互通，需分别设置

主菜单是大部分功能的入口，通过 +cd 命令或手持时钟物品右键打开。

1. 主菜单 → 传送系统 → 个人传送点

2. 点击「添加」创建新传送点

3. 设置名称、图标、位置（当前位置或手动输入坐标）

4. 可设置一个 Home 点，使用 +home 快速传送

1. 主菜单 → 传送系统 → 传送玩家

2. 选择目标玩家

3. 选择传送方向：

   • 「我过去」- 传送到对方位置
   • 「他过来」- 对方传送到你位置

4. 对方收到请求后输入 +tpaccept 接受

1. 选择第一个角点：空手，潜行（按住 Shift）单击方块

2. 选择对角点：不潜行，单击对角位置的方块

3. 打开创建界面：输入 +land 或主菜单 → 领地 → 创建

4. 设置领地信息：

   • 领地名称
   • Y轴范围（高度限制）
   • 预览领地区域

5. 确认创建：扣除相应费用（需记分板货币）

1. 输入 +op 打开管理界面

2. 插件设置 → 全局商店设置

3. 管理全局商店 → 添加/编辑商品

4. 设置商品信息、货币、分组等

chat.format: "[/tag]/sender >> /text"

可用变量：

• /sender - 发送者名称
• /tag - 聊天头衔
• /text - 聊天内容

1. 管理员给玩家添加标签：/tag 玩家名 add usf.tag:§6[大佬]§r

2. 玩家聊天时头衔会显示在名字前

3. 使用 usf.tag:Reset 重置头衔

1. 主菜单 → 群组 → 新建群组

2. 填写群组名称、公告

3. 创建成功后获得群组ID

1. 主菜单 → 群组 → 加入群组

2. 输入群组ID

3. 等待群主同意

• 群组传送点
• 群聊消息
• 群组公告
• 成员管理（踢人、设置管理员）
• 入群申请处理

策略文件是 USF 的自定义 UI 系统，可以创建交互式菜单。

使用方式：

• 右键空气：打开配置的界面
• 潜行+右键方块：绑定界面到方块
• 右键NPC：绑定界面到NPC

操作面板功能：

• 填充方块（全部/替换/轮廓）
• 导出为结构文件

log.able: true
log.address: "http://127.0.0.1:1024/"
log.down: 30  // 重连间隔（秒）
log.allow: ["chat", "die", "kill"]  // 启用的日志类型

通过管理界面可以：

• 创建/删除记分板
• 设置显示位置（侧边栏/玩家列表）
• 修改玩家分数
• 设置默认值

可自动统计以下数据到记分板：

管理员可以配置在特定事件发生时自动执行命令：

在配置文本（如公告、欢迎语、聊天格式）中可使用以下变量：

悬浮字是带有 Float 标签的蝙蝠实体，用于展示文本。

1. 主菜单 → 管理界面 → 管理悬浮字

2. 点击「添加悬浮字」

3. 设置文本内容、坐标、备注

• 不会自然消失
• 可通过管理界面移动位置
• 支持变量转义

{
  // 命令配置
  commands: ["cd", "op", "tpaccept", "home"],

  // 传送配置
  tp: {
    random_range: 10000,  // 随机传送范围
    per: true,            // 允许个人传送点
    per_count: 50,        // 个人传送点上限
    back: false,          // 允许返回死亡点
    down: 30,             // 冷却时间
    animation: false      // 传送动画
  },

  // 领地配置
  land: {
    able: false,          // 启用领地
    max: 2,               // 最大领地数
    price: 0,             // 创建费用
    mode: false           // 领地模式切换
  },

  // 聊天配置
  chat: {
    format: "[/tag]/sender >> /text",
    length: 1024,         // 消息长度限制
    disable: false        // 禁用聊天
  },

  // 商店配置
  store: {
    able: false,          // 启用商店
    moneys: "",           // 货币记分板
    groups: {}            // 商品分组
  }
}