server tools mod

模组

· 作者 Coffeecat2006

此 Fabric 服务器模组将兑换码系统与完整的邮件功能相结合。

0 本站下载 0 关注 更新于 1 年前

最新 1.0.3 · 1.21.5 · Fabric

一键开服(送7天)

server tools mod

版本: 1.0.3 Minecraft: 1.21.5 Fabric Loader: 1.21.5 Fabric API: 0.88.0+ Java: 17+

一款 Fabric 伺服器模組,讓管理員可動態建立、管理「禮包碼」,玩家輸入後可領取自訂物品、訊息,並自動執行伺服器指令。支援完整郵件系統,方便玩家互相寄送信件與物品。

A Fabric server-side mod that allows administrators to dynamically create and manage "redeem codes". Players can enter codes to claim custom items and messages, and trigger server commands automatically. It also includes a full-featured mail system so that players can send letters and items to each other.


Description language/簡介語言


功能總覽

  • 動態禮包碼管理:即時建立、刪除、列出和查詢禮包碼。
  • 自訂獎勵:定義自訂物品堆疊和文字訊息。
  • 進階編輯:實時調整禮包碼屬性,包括物品、訊息、領取限制、過期時間以及單次/多次使用規則。
  • 隱藏代碼:將代碼標記為隱藏,如果玩家嘗試使用這些代碼,他們會收到「找不到代碼」的提示。
  • 自訂事件鉤子:在兌換代碼時執行一個或多個伺服器指令(支持其他模組指令)。使用 @s 來鎖定領取者玩家。
  • 審計日誌:完整記錄所有代碼的創建、編輯和兌換操作,以便審計和審查。
  • 郵件系統:支持玩家之間的郵件發送物品,具備黑名單、批量刪除和日誌功能。
  • 持久化:所有數據自動保存到世界資料夾,並在伺服器重啟時重新載入。
  • MIT 授權:開源 — 可自由修改和分發。

安裝

  1. 將 server_tools_mod-1.0.3.jar 放入您的 mods/ 資料夾中(需要 Fabric API)。
  2. 啟動伺服器或客戶端(不需要在客戶端安裝,僅需安裝在伺服器端)。

禮包碼指令

新增 / 刪除 / 列出

# 新增一個禮包碼
/redeem add <code> "<message>" <limit> <time> <singleUse>
# 例如:單次使用,1440 分鐘(24 小時)後過期
/redeem add VIP123 "歡迎,VIP!" 1 1440 true

# 刪除一個代碼
/redeem remove <code>

# 列出所有代碼(僅管理員)
/redeem list

兌換

# 玩家兌換代碼
/redeem <code>

預覽

# 預覽代碼的物品(僅管理員)
/redeem preview item <code>

# 預覽文字訊息
/redeem preview text <code>

# 預覽事件
/redeem preview event <code> all
/redeem preview event <code> <eventName>

修改現有代碼

使用 /redeem modify <code> <field> [args...] 來調整現有代碼。

物品

  • item reset:清除該代碼的物品列表。
  • item transform:用管理員副手持有的物品替換列表。
  • item add:將管理員副手的物品追加到現有列表中。

字段

  • code <newCode>:重命名代碼。
  • text "<newMessage>":更新兌換訊息。
  • limit <number|infinity>:設置總領取限制(-1 表示無限制)。
  • time <minutes|infinity>:設置以分鐘為單位的過期時間或 infinity(無限期)。
  • rules <true|false>:每位玩家僅可使用一次(true)或允許每位玩家多次使用(false)。
  • receive_status <playerUUID> <true|false>:手動標記某位玩家是否已領取(或未領取)。
  • available <true|false>:顯示(true)或隱藏(false)此代碼。

事件

  • event add <eventName> <command…>:添加一條在兌換時運行的伺服器指令。使用 @s 代表領取者玩家。 例如:/redeem modify VIP123 event add greet title @s title "Welcome VIP"
  • event remove <eventName>:移除指定名稱的事件。
  • event reset:清除所有事件。

查看日誌

# 顯示所有日誌
/redeem log all [recent <n>] [page <p>]

# 顯示某個代碼的編輯歷史
/redeem log code <code> edits [recent <n>] [page <p>]

# 顯示某個代碼的兌換歷史
/redeem log code <code> redeems [recent <n>] [page <p>]

# 顯示某位玩家的所有操作
/redeem log player <player> [recent <n>] [page <p>]

幫助

# 顯示兌換指令概覽
/redeem help

# 顯示特定子指令的詳細幫助
/redeem help <subcommand>

郵件指令

開啟信箱

/mail open [<page>]
  • 列出玩家的信箱(每頁 5 條訊息)。默認第 1 頁。

發送郵件

/mail send <player> <title> <content> <item>
  • player:單一玩家 ID 或 "@a" / "all"(僅管理員可用)。
  • title:郵件主題。
  • content:正文內容(使用 \n 進行換行)。
  • item:設為 true 以附加管理員副手中的物品,設為 false 則不附加。

閱讀郵件

/mail read <id>
  • 查看並將指定郵件標記為已讀。

收取包裹

/mail pickup <id>
  • 領取郵件中附帶的物品。

刪除郵件

/mail delete <id>
  • 提示 [Confirm] [Cancel]。運行 /mail delete <id> confirm 以繼續。

批量刪除

/mail delete all [read|received]
  • all:刪除所有訊息。
  • read:刪除所有已讀訊息。
  • received:刪除所有已領取物品的訊息。
  • 需要確認。

黑名單

/mail blacklist
/mail blacklist add <player>
/mail blacklist remove <player>
  • 所有更改都需要確認。

日誌查詢(管理員)

/mail log [<page>]
  • 所有郵件交易的分頁列表:[timestamp] sender -> recipient <id> [View]。

幫助

/mail help
  • 顯示郵件指令概覽。

授權

本模組根據 MIT 許可證授權。詳情請參見 LICENSE 文件。


其他

請使用中文或英文報告問題。


功能總覽

  • 動態禮包碼管理:可隨時建立、刪除、列出、查詢禮包碼
  • 自訂回饋內容:支援自訂物品列表、文字訊息
  • 進階修改功能:可動態調整禮包碼內容,包括物品、訊息、領取上限、有效時間、單/多次領取規則等
  • 隱藏/顯示禮包碼:可設定禮包碼為隱藏,玩家輸入隱藏碼時會顯示「無此禮包碼」
  • 自訂事件觸發:領取時可執行一或多個伺服器指令(支援其他模組指令),指令目標可用 @s 代表領取玩家
  • 領取與編輯日誌:完整記錄所有禮包碼的領取與編輯操作,方便查詢
  • 信箱系統:支援玩家間寄送信件與物品,含黑名單、批量刪除、日誌查詢等功能
  • 自動持久化存檔:所有資料自動儲存於世界存檔,伺服器重啟後自動載入
  • MIT 授權:開源、可自由修改與分發

安裝

  1. 把 server_tools_mod-1.0.3.jar 放到 mods/ 資料夾(需同時放 Fabric API)
  2. 啟動伺服器或客戶端(客戶端非必要安裝,僅伺服器端需要)

礼包码指令用法

新增 / 移除 / 列表

# 新增一组 Code
/redeem add <code> "<message>" <limit> <time> <singleUse>
# 例如:仅限领一次、24 小时过期
/redeem add VIP123 "Welcome, VIP!" 1 1440 true

# 删除 Code
/redeem remove <code>

# 列出所有 Code(管理员专用)
/redeem list

兑换

# 玩家输入 Code
/redeem <code>

预览(管理员专用)

# 预览物品
/redeem preview item <code>

# 预览文字
/redeem preview text <code>

# 预览事件
/redeem preview event <code> all

/redeem preview event <code> <eventName>

修改现有 Code

管理员可用 /redeem modify 指令动态调整已存在的 Code。

/redeem modify <code> <field> [args...]

物品

  • item reset:清空该 Code 的物品列表
  • item transform:将物品列表替换为管理员当前副手持物
  • item add:在现有列表后追加管理员当前副手持物

字段

  • code <newCode>:重新命名 Code
  • text "<newMessage>":更新领取后显示的文字
  • limit <number|infinity>:设定总领取次数上限(-1 表示无限)
  • time <minutes|infinity>:设定过期时间(分),或 infinity
  • rules <true|false>:单/多次领取规则(true = 单次每人)
  • receive_status <playerUUID> <true|false>:手动标记某玩家是否已领取
  • available <true|false>:显示(true)或隐藏(false)此 Code

事件

  • event add <eventName> <command…>:新增一个领取时执行的服务器指令,@s 解析为领取玩家
    例: /redeem modify VIP123 event add greet title @s title "欢迎 VIP"
  • event remove <eventName>:移除指定事件
  • event reset:清空所有事件

查阅日志

# 显示所有日志
/redeem log all [recent <n>] [page <p>]

# 查询指定 Code 的编辑记录
/redeem log code <code> edits [recent <n>] [page <p>]

# 查询指定 Code 的领取记录
/redeem log code <code> redeems [recent <n>] [page <p>]

# 查询指定玩家的所有操作记录
/redeem log player <player> [recent <n>] [page <p>]

帮助

# 显示所有 /redeem 指令概述
/redeem help

# 显示指定子指令详细说明
/redeem help <子指令>

信箱指令用法

开启信箱

/mail open [<页码>]
  • 列出当前玩家信箱,每页最多 5 封信
  • 若不输入页码则默认为1

寄送信件

/mail send <player> <title> <content> <item>
  • player:若为管理员可输入 "@a" 或 "all",否则仅单一玩家 ID(输入这两种类型时请使用双引号)
  • title:信件标题
  • content:内容,可用 换行
  • item:true 打包副手物品、false 无包裹

查看信件

/mail read <id>
  • 显示指定 ID 信件内容,并标记为已阅读

领取包裹

/mail pickup <id>
  • 领取信件中包裹物品

删除信件

/mail delete <id>
  • 命令后会出现 [确认] [取消] 按钮,再次输入 /mail delete <id> confirm 或 cancel

批量删除

/mail delete all [read|received]
  • all:删除所有
  • read:删除所有已阅读
  • received:删除所有已领包裹
  • 同样需后续 confirm 或 cancel

黑名单

/mail blacklist
/mail blacklist add <player>
/mail blacklist remove <player>
  • add/remove 操作皆需 confirm

日志查询(管理员)

/mail log [<page>]
  • 分页显示所有寄送记录,格式:[时间] sender -> recipient <id> [查看]

帮助

/mail help
  • 显示所有 /mail 指令概述

授权

本模组采用 MIT License,详见 LICENSE 文件。

其他

问题反馈可使用中文,英文

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源