NotItem

插件

· 作者 sukukai

一个简单的插件,让你可以轻松在箱子菜单中创建禁用的物品

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

最新 1.2.0 · 26.3 · Bukkit / Paper

一键开服(送7天)

NotItem

日本語の説明は ページ下部 にあります

chest

NotItem 是一个轻量级插件,用于按世界或全局限制特定物品。

通过图形界面轻松管理受限物品——无需输入物品 ID。

非常适合大厅服务器、冒险地图和受控生存环境。


功能

  • 按世界限制和全局列表 (all)
  • 基于简单 GUI 的管理 (/notitem gui)
  • 快捷命令:使用 /notitem add 一键添加手中的物品
  • 即时移除物品,对性能影响极小
    • 拾取、背包点击、拖拽、合成及物品使用均被阻止
    • 也会检查盔甲、副手、光标以及 潜影盒内容物
  • 绕过权限 (notitem.bypass,默认 OP)
  • 通过 language.yml 完全自定义消息
  • 防垃圾信息:重复的“物品已移除”消息会被节流处理
  • 自动从旧版本更新 config.yml / language.yml

命令与权限

命令

/notitem gui [world | all]            - 打开 GUI 以管理受限物品(默认:all)
/notitem list [world | all]           - 查看受限物品
/notitem add [world | all] [item]     - 添加受限物品
/notitem remove [world | all] [item]  - 移除受限物品
/notitem reload                       - 重新加载 config.yml 和 language.yml

add / remove 快捷方式:

命令 效果
/notitem add 将 主手物品 添加到 all
/notitem add <world> 将主手物品添加到 <world>
/notitem add <item> 将 <item> 添加到 all(当它不是世界名称时)
/notitem add <world> <item> 将 <item> 添加到 <world>

remove 工作方式相同。<world> 必须是 all 或一个存在的世界。

权限

权限 描述 默认值
notitem.admin 使用所有 /notitem 命令 OP
notitem.bypass 不受物品限制影响 OP

配置

config.yml

# "all" 适用于所有世界。
restricted-items:
  world:
    - TNT
    - BEDROCK
  all:
    - COMMAND_BLOCK

# 定期扫描库存的时间间隔(以刻为单位)。20 = 1 秒,0 = 禁用。
scan-interval-ticks: 20

# 同一物品的“物品已移除”消息之间的最小时间间隔(毫秒)。
message-cooldown-ms: 3000

将 world 替换为具体的世界名称,或使用 all 以全局应用限制。 支持包含点的世界名称(例如 survival.nether)。

language.yml

language.yml (默认:日语)
# Message language file
# lang-version is managed by the plugin. Do not edit it.
lang-version: 1
prefix: "&7[&cNotItem&7] &r"
item-removed: "&e%world%&r では &c%item%&r の所持は禁止されているため削除しました。"
reload-success: "&a設定を再読み込みしました。"
no-permission: "&c権限がありません。"
usage: "&e使用法: /notitem <add | remove | list | gui | reload>"
item-added: "&a%item% を %world% の禁止リストに追加しました。"
item-already-listed: "&e%item% は既に %world% の禁止リストに登録されています。"
item-removed-list: "&e%item% を %world% の禁止リストから削除しました。"
item-not-listed: "&e%item% は %world% の禁止リストに登録されていません。"
invalid-material: "&c無効なアイテム名です。"
invalid-world: "&c無効なワールド名です。(all または存在するワールド名を指定してください)"
no-held-item: "&c手にアイテムを持っていません。アイテム名を指定するか、アイテムを手に持ってください。"
player-only: "&cこのコマンドはプレイヤーのみ実行できます。"
save-failed: "&c設定ファイルの保存に失敗しました。コンソールを確認してください。"

# List command
list-header: "&e--- 禁止アイテムリスト (%world%) ---"
list-item: "&7- &f%item%"
list-empty: "&7このワールドには禁止アイテムはありません。"
list-all-header: "&e--- 全世界の禁止アイテムリスト ---"
list-world-format: "&b%world%&f: &7%items%"

# Help messages
help-header: "&e======= &bNotItem Help &e======="
help-add: "&b/notitem add [world | all] [item] &7- 禁止アイテムを追加 (省略時: all / 手持ちのアイテム)"
help-remove: "&b/notitem remove [world | all] [item] &7- 禁止アイテムを削除 (省略時: all / 手持ちのアイテム)"
help-list: "&b/notitem list [world | all] &7- 禁止リストを表示"
help-gui: "&b/notitem gui [world | all] &7- GUIで禁止アイテムを管理 (省略時: all)"
help-reload: "&b/notitem reload &7- 設定を再読み込み"
help-footer: "&e============================"

# GUI
gui-title: "&8禁止アイテム設定: &5%world%"
gui-saved: "&a%world% の禁止リストを保存しました。"
gui-overflow: "&eGUIに表示しきれない %count% 件のアイテムがあります。これらは /notitem remove で個別に削除できます。"
language.yml (示例:英语)
# Message language file
# lang-version is managed by the plugin. Do not edit it.
lang-version: 1
prefix: "&7[&cNotItem&7] &r"
item-removed: "&e%item%&r is not allowed in &e%world%&r and has been removed."
reload-success: "&aConfiguration reloaded successfully."
no-permission: "&cYou do not have permission."
usage: "&eUsage: /notitem <add | remove | list | gui | reload>"
item-added: "&aAdded %item% to the restricted list of %world%."
item-already-listed: "&e%item% is already in the restricted list of %world%."
item-removed-list: "&eRemoved %item% from the restricted list of %world%."
item-not-listed: "&e%item% is not in the restricted list of %world%."
invalid-material: "&cInvalid item name."
invalid-world: "&cInvalid world name. (use 'all' or an existing world)"
no-held-item: "&cYou are not holding an item. Specify an item name or hold one in your hand."
player-only: "&cThis command can only be used by players."
save-failed: "&cFailed to save the configuration file. Check the console."

# List command
list-header: "&e--- Restricted Items (%world%) ---"
list-item: "&7- &f%item%"
list-empty: "&7No restricted items in this world."
list-all-header: "&e--- Global Restricted Items ---"
list-world-format: "&b%world%&f: &7%items%"

# 帮助信息
help-header: "&e======= &bNotItem 帮助 &e======="
help-add: "&b/notitem add [world | all] [item] &7- 添加受限物品(默认:所有/手持物品)"
help-remove: "&b/notitem remove [world | all] [item] &7- 移除受限物品(默认:所有/手持物品)"
help-list: "&b/notitem list [world | all] &7- 显示受限物品"
help-gui: "&b/notitem gui [world | all] &7- 通过 GUI 管理受限物品(默认:所有)"
help-reload: "&b/notitem reload &7- 重新加载配置"
help-footer: "&e============================"

# GUI
gui-title: "&8受限物品: &5%world%"
gui-saved: "&a已保存 %world% 的受限列表。"
gui-overflow: "&e%count% 个物品无法在 GUI 中显示。请使用 /notitem remove 逐个删除它们。"

要将插件语言切换为英文,请将 language.yml 的内容替换为上述示例并运行 /notitem reload。


从旧版本更新

只需替换 jar 文件并重启(或重载)服务器。首次启动时,插件将执行以下操作:

  • 向 config.yml 和 language.yml 添加新键(保留现有值)
  • 将仍使用旧默认值的消息更新为新措辞;您自定义的消息不会被修改
  • 将之前的文件备份为 config.yml.bak 和 language.yml.bak
  • 恢复名称中包含点的世界的受限列表(旧版本保存不正确)

1.0.0 以来的更改

  • 新增:/notitem add / remove 快捷方式(手持物品,默认 all),gui 默认打开 all
  • 新增:notitem.bypass 权限、scan-interval-ticks 和 message-cooldown-ms 选项
  • 新增:检查潜影盒内容物、盔甲、副手和光标
  • 修复:关闭 GUI 时会丢失超过 54 个的受限物品
  • 修复:物品仍可被使用或拾取一瞬间;事件现在会被取消
  • 修复:添加已列出的物品或删除未列出的物品时的错误消息
  • 修复:名称中包含点的世界未被正确处理
  • 修复:重复点击时出现过多的“物品已移除”消息
  • 再次支持 Java 8+(构建为 Java 8 字节码),支持 Minecraft 1.13 – 1.21.x

兼容性

  • 服务器: Spigot / Paper 1.13 – 1.21.x
  • Java: 8 或更高版本(jar 构建为 Java 8 字节码,因此也可在新版 Java 上运行)
  • 基于 Spigot API 1.20.1 构建,设置 api-version: 1.13

源代码在 CI 中与 Spigot API 1.13.2、1.16.5、1.19.4 和 1.21.4 进行编译检查。 除 1.20.1 外的 Minecraft 版本未在实时服务器上进行主动测试。


注意事项

  • 此插件不使用 NMS 或特定版本的代码。
  • 设计为轻量级且安全,适合长期服务器运行。
  • 在 Paper / Spigot 服务器上效果最佳。

日本語説明

NotItem は、特定のワールド(または全ワールド)で特定のアイテムの所持・使用を制限できる、軽量な Minecraft サーバー用プラグインです。 GUI ベースの直感的な管理により、アイテム ID を調べることなく簡単に制限設定を行えます。

ロビーサーバー、アドベンチャーマップ、管理されたサバイバル環境など、 アイテム制御が必要なあらゆるサーバーに最適です。


主な機能

  • ワールド別・全ワールド共通(all)のアイテム制限に対応
  • /notitem gui による GUI 管理(アイテム ID 入力不要)
  • /notitem add だけで 手に持っているアイテムを禁止リストに追加
  • アイテムの取得・移動・ドラッグ・クラフト・使用を検知し、即座に削除・キャンセル
    • 防具・オフハンド・カーソル・シュルカーボックスの中身も対象
  • notitem.bypass 権限を持つプレイヤー(デフォルトは OP)は制限対象外
  • language.yml による完全なメッセージカスタマイズ対応
  • 連打時の「削除しました」通知を自動的に間引き
  • 旧バージョンの config.yml / language.yml を自動で更新

コマンドと権限

コマンド

/notitem gui [world | all]            - GUI で禁止アイテムを管理 (省略時: all)
/notitem list [world | all]           - 禁止アイテム一覧を表示
/notitem add [world | all] [item]     - 禁止アイテムを追加
/notitem remove [world | all] [item]  - 禁止アイテムを削除
/notitem reload                       - config.yml と language.yml を再読み込み

add / remove の省略形:

コマンド 動作
/notitem add メインハンドに持っているアイテムを all に追加
/notitem add <world> 持っているアイテムを <world> に追加
/notitem add <item> <item> を all に追加(ワールド名として解決できない場合)
/notitem add <world> <item> <item> を <world> に追加

remove も同様です。<world> は all または存在するワールド名を指定してください。

権限

権限 説明 デフォルト
notitem.admin /notitem の全コマンドを使用 OP
notitem.bypass アイテム制限の対象外になる OP

設定ファイル

config.yml

# "all" は全ワールドに適用されます
restricted-items:
  world:
    - TNT
    - BEDROCK
  all:
    - COMMAND_BLOCK

# 所持品を定期チェックする間隔(tick)。20 = 1秒、0 = 無効
scan-interval-ticks: 20

# 同じアイテムの「削除しました」通知の最小間隔(ミリ秒)
message-cooldown-ms: 3000

world の部分は実際のワールド名に置き換えてください。all は全ワールド共通です。 survival.nether のようにドットを含むワールド名にも対応しています。

language.yml

デフォルトは日本語です。全文は上の英語セクションの language.yml (default: Japanese) を参照してください。 英語に切り替えるには、language.yml (example: English) の内容に置き換えて /notitem reload を実行します。


旧バージョンからのアップデート

jar を差し替えてサーバーを再起動(または reload)するだけです。初回起動時に次の処理を自動で行います。

  • config.yml と language.yml に新しい項目を追加(既存の値は保持)
  • 旧バージョンの既定のままのメッセージだけを新しい文言に更新(自分で書き換えたメッセージは変更しません)
  • 更新前のファイルを config.yml.bak / language.yml.bak として保存
  • 旧バージョンで正しく保存されなかった、ドットを含むワールド名の設定を復元

1.0.0 からの変更点

  • 追加: /notitem add / remove の省略形(手持ちのアイテム、省略時は all)、gui は省略時 all を開く
  • 追加: notitem.bypass 権限、scan-interval-ticks / message-cooldown-ms 設定
  • 追加: シュルカーボックスの中身・防具・オフハンド・カーソルのチェック
  • 修正: GUI を閉じると 54 件を超える禁止アイテムが失われる問題
  • 修正: アイテムの取得・使用が一瞬通ってしまう問題(イベントをキャンセルするよう変更)
  • 修正: 登録済みアイテムの追加・未登録アイテムの削除時のメッセージ
  • 修正: ドットを含むワールド名が正しく扱われない問題
  • 修正: 連打時に通知が大量に出る問題
  • Java 8 以上で動作(Java 8 向けにビルド)。Minecraft 1.13 – 1.21.x に対応

対応環境

  • サーバー: Spigot / Paper 1.13 – 1.21.x
  • Java: 8 以上(Java 8 向けのバイトコードでビルドしているため、新しい Java でも動作します)
  • Spigot API 1.20.1 でビルド(api-version: 1.13)

Spigot API 1.13.2 / 1.16.5 / 1.19.4 / 1.21.4 に対するコンパイルを CI で確認しています。 1.20.1 以外のバージョンについては、実サーバーでの継続的な検証は行っていません。


デフォルト言語:日本語(language.yml で自由に変更可能)

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源