NotEntity

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

!chest

NotEntity is a lightweight plugin that restricts specific entities (mobs, items, boats, etc.) per world or globally.

Manage restricted entities easily via a GUI — no complex configuration required.

Perfect for lobby servers, creative worlds, and lag reduction.

Features

• Per-world restrictions and a global list (all)
• Simple GUI-based management (/notentity gui) — restricted entities are shown as spawn eggs
• Quick commands: add the spawn egg in your hand with a single /notentity add
• Toggle "Delete All Mobs" (MOBall) or "Delete Items" per world with one click
• Toggle boats and chest boats separately per world (all wood types and bamboo rafts)
• Spawns are cancelled instantly; a periodic scan and chunk-load check remove entities that already exist
• "Delete All Mobs" exclusions: armor stands (default), named entities, tamed pets, villagers, spawn reasons
• Bypass permission (notentity.bypass, OP by default): items they drop are not deleted
• Fully customizable messages via language.yml
• Automatic update of config.yml / language.yml from older versions

Commands & Permissions

Commands

/notentity gui [world | all]             - Open the GUI to manage restrictions (default: all)
/notentity list [world | all]            - View current restrictions
/notentity add [world | all] [entity]    - Add a restricted entity
/notentity remove [world | all] [entity] - Remove a restricted entity
/notentity reload                        - Reload config.yml and language.yml

add / remove shortcuts:

remove works the same way. <world> must be all or an existing world (case-insensitive). <entity> is an entity type such as ZOMBIE, or a spawn egg name such as ZOMBIE_SPAWN_EGG. Entities that have no spawn egg (e.g. ARMOR_STAND, PRIMED_TNT, ITEM_FRAME) can be added by name.

GUI

• The first four slots toggle Delete Items, Delete All Mobs, Delete Boats and Delete Chest Boats (click).
• Every other slot holds a restricted entity as a spawn egg (or a representative item).
• Put a spawn egg in (drag / shift-click / click) to restrict that entity, take it out to lift the restriction.
• Closing the GUI saves it. Items that are not entities are given back to you.
• Restrictions that cannot be shown (more than 50, or without a distinct icon) are kept; manage them with /notentity remove.

Permissions

Configuration

Both files are in plugins/NotEntity/. Edit them with the server running and apply the changes with /notentity reload. The restrictions themselves are best managed with /notentity or the GUI; the plugin writes them back into config.yml.

config.yml

# "all" applies to every world.
worlds:
  world:
    item-delete: false
    mob-all: false
    boat: false          # remove ordinary boats
    chest-boat: false    # remove chest boats
    restricted-entities:
      - CREEPER
      - PHANTOM
  all:
    mob-all: false

# Interval (in ticks) of the safety-net scan of loaded entities. 20 = 1 second, 0 = disabled.
# New spawns are cancelled immediately by events, so this does not need to be short.
scan-interval-ticks: 100

# Entities that "Delete All Mobs" (mob-all) must NOT remove.
# Types listed in restricted-entities are always removed.
mob-all-exclusions:
  armor-stands: true
  named-entities: false   # entities that have a custom name (name tag)
  tamed-entities: false   # tamed pets
  villagers: false
  # Entities spawned for these reasons are kept, e.g. [CUSTOM, SPAWNER_EGG]
  spawn-reasons: []

# Managed by the plugin. Do not edit.
config-version: 1

Notes:

• The world key all applies to every world. A world named all therefore cannot be configured separately.
• A world's settings and the all settings are combined: an entity is removed if either one restricts it.
• Entities listed in restricted-entities are removed even if mob-all-exclusions would keep them.
• World names containing dots (e.g. survival.nether) are supported.
• Unknown entity names are kept (with a console warning) instead of being deleted on save. Use /notentity remove <world> <name> to clear them.
• If config.yml cannot be parsed, the plugin keeps the previous settings and refuses to overwrite the file.
• Entity type names are those of the Minecraft version your server runs. Names that were renamed between versions are resolved automatically (e.g. MUSHROOM_COW / MOOSHROOM).

language.yml

All messages are in language.yml. Color codes use &. The following placeholders are replaced:

Keys that are missing are filled in from the defaults bundled with the jar, so a partial file is fine. lang-version is managed by the plugin.

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

# List command
list-header: "&e--- 制限リスト (%world%) ---"
list-item-delete: "&7アイテム削除: %state%"
list-mob-all: "&7全モブ削除 (MOBall): %state%"
list-boat: "&7ボート削除: %state%"
list-chest-boat: "&7チェスト付きボート削除: %state%"
list-item: "&7- &f%item%"
list-empty: "&7制限はありません。"
list-all-header: "&e--- 全世界の制限リスト ---"
list-world-format: "&b%world%&f: &7%items%"
flag-item-delete: "アイテム削除"
flag-mob-all: "全モブ削除"
flag-boat: "ボート削除"
flag-chest-boat: "チェスト付きボート削除"
state-on: "&aON"
state-off: "&7OFF"

# Help messages
help-header: "&e======= &bNotEntity Help &e======="
help-add: "&b/notentity add [world | all] [entity] &7- 制限を追加 (省略時: all / 手持ちのスポーンエッグ)"
help-remove: "&b/notentity remove [world | all] [entity] &7- 制限を解除 (省略時: all / 手持ちのスポーンエッグ)"
help-list: "&b/notentity list [world | all] &7- 制限リストを表示"
help-gui: "&b/notentity gui [world | all] &7- GUIで制限を管理 (省略時: all)"
help-reload: "&b/notentity reload &7- 設定を再読み込み"
help-footer: "&e============================"

# GUI
gui-title: "&8モブ制限設定: &5%world%"
gui-saved: "&a%world% の制限リストを保存しました。"
gui-overflow: "&eGUIに表示できない %count% 件の制限があります。これらは /notentity remove で個別に削除できます。"
gui-returned: "&eエンティティとして扱えないアイテムを返却しました。"
toggle-item-on: "&aアイテム削除: ON"
toggle-item-off: "&7アイテム削除: OFF"
toggle-moball-on: "&a全モブ削除 (MOBall): ON"
toggle-moball-off: "&7全モブ削除: OFF"
toggle-boat-on: "&aボート削除: ON"
toggle-boat-off: "&7ボート削除: OFF"
toggle-chestboat-on: "&aチェスト付きボート削除: ON"
toggle-chestboat-off: "&7チェスト付きボート削除: OFF"
toggle-description: "&eクリックで切り替え"

# Message language file
# lang-version is managed by the plugin. Do not edit it.
lang-version: 2
prefix: "&7[&cNotEntity&7] &r"
reload-success: "&aConfiguration reloaded successfully."
no-permission: "&cYou do not have permission."
usage: "&eUsage: /notentity <add | remove | list | gui | reload>"
entity-added: "&aAdded %entity% to the restricted list of %world%."
entity-already-listed: "&e%entity% is already in the restricted list of %world%."
entity-removed-list: "&eRemoved %entity% from the restricted list of %world%."
entity-not-listed: "&e%entity% is not in the restricted list of %world%."
invalid-entity: "&cInvalid entity name: &f%entity%"
invalid-world: "&cInvalid world name. (use 'all' or an existing world)"
no-held-item: "&cYou are not holding an item. Specify an entity name or hold a spawn egg."
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--- Restrictions (%world%) ---" list-item-delete: "&7Delete Items: %state%" list-mob-all: "&7Delete All Mobs (MOBall): %state%" list-boat: "&7Delete Boats: %state%" list-chest-boat: "&7Delete Chest Boats: %state%" list-item: "&7- &f%item%" list-empty: "&7No restrictions." list-all-header: "&e--- Global Restrictions ---" list-world-format: "&b%world%&f: &7%items%" flag-item-delete: "Delete Items" flag-mob-all: "Delete All Mobs" flag-boat: "Delete Boats" flag-chest-boat: "Delete Chest Boats" state-on: "&aON" state-off: "&7OFF"

Help messages

help-header: "&e======= &bNotEntity Help &e=======" help-add: "&b/notentity add [world | all] [entity] &7- Add a restriction (default: all / held spawn egg)" help-remove: "&b/notentity remove [world | all] [entity] &7- Remove a restriction (default: all / held spawn egg)" help-list: "&b/notentity list [world | all] &7- Show restrictions" help-gui: "&b/notentity gui [world | all] &7- Manage restrictions via GUI (default: all)" help-reload: "&b/notentity reload &7- Reload configuration" help-footer: "&e============================"

GUI

gui-title: "&8Entity Limit: &5%world%" gui-saved: "&aSaved the restricted list of %world%." gui-overflow: "&e%count% restriction(s) cannot be shown in the GUI. Use /notentity remove to delete them individually." gui-returned: "&eItems that are not entities were returned to you." toggle-item-on: "&aDelete Items: ON" toggle-item-off: "&7Delete Items: OFF" toggle-moball-on: "&aDelete All Mobs: ON" toggle-moball-off: "&7Delete All Mobs: OFF" toggle-boat-on: "&aDelete Boats: ON" toggle-boat-off: "&7Delete Boats: OFF" toggle-chestboat-on: "&aDelete Chest Boats: ON" toggle-chestboat-off: "&7Delete Chest Boats: OFF" toggle-description: "&eClick to toggle"

</details>

To switch the plugin language to English, replace the contents of `language.yml` with the example above and run `/notentity reload`.

---

## Updating from an older version

Just replace the jar and restart (or reload) the server. On first start the plugin:

* adds the new keys to `config.yml` and `language.yml` (your existing values are kept)
* updates messages that are still the old defaults to the new wording; messages you customized are **not** touched
* keeps a backup of the previous files as `config.yml.bak` and `language.yml.bak`
* restores restrictions of worlds whose names contain dots, which older versions saved incorrectly

The old `/notentity <world>` form still opens the GUI, but `/notentity gui <world>` is the documented one.

### Changes in 1.2.0

* New: **Delete Boats** and **Delete Chest Boats** toggles per world (GUI, `config.yml` keys `boat` / `chest-boat`, shown by `/notentity list`)
* GUI: the entity list now starts at the fifth slot (the first four are toggles)
* Commands and GUI reworked to work like NotItem: `gui` / `list` / `add` / `remove` / `reload`, help screen, held spawn egg shortcut
* Fixed: restrictions written by hand (entities without a spawn egg, unknown names, more than the GUI can show) were lost when the GUI was closed
* Fixed: world names were case-sensitive, which split the settings; "Delete All Mobs" removed armor stands
* Fixed: a broken `config.yml` could be overwritten; world names containing dots were saved incorrectly

---

## Compatibility

* **Server**: Spigot / Paper 1.13 – 1.21.x
* **Java**: 8 or higher (the jar is built as Java 8 bytecode, so it also runs on newer Java)
* Built against the Spigot API **1.20.1** with `api-version: 1.13`

> The source is compile-checked against the Spigot API 1.13.2, 1.16.5, 1.19.4 and 1.21.4 in CI.
> Minecraft versions other than 1.20.1 are not actively tested on a live server.

---

## Notes

* **Delete All Mobs** removes all living entities except players and anything matched by `mob-all-exclusions`. Entities listed in `restricted-entities` are always removed, even if they would be excluded.
* **Delete Items** removes dropped items on the ground, except items dropped by players with `notentity.bypass`.
* **Boats** / **Chest Boats** are switched independently and cover every wood type (and bamboo rafts on 1.20+). On servers older than 1.19 there are no chest boats.
* Restrictions set on the `all` "world" affect **every world** on the server.
* If two admins edit the same world's GUI at once, the one who closes it last wins.
* Spawn eggs put into the GUI are consumed, and eggs taken out of it are real items (same behavior as NotItem).
* This plugin does **not** use NMS or version-specific code.

---

## 日本語説明

NotEntity は、特定のワールド（または全ワールド）で特定のエンティティ（モブ・アイテム・ボートなど）の**スポーン・存在を制限**できる、軽量な Minecraft サーバー用プラグインです。
GUI ベースの直感的な管理により、複雑な設定ファイル編集なしで制限を行えます。

ロビーサーバーでのモブ湧き防止や、特定のワールドでのアイテム削除（ラグ対策）などに最適です。

---

### 主な機能

- ワールド別・全ワールド共通（`all`）の制限設定
- `/notentity gui` による **GUI 管理**（制限中のエンティティはスポーンエッグとして表示）
- `/notentity add` だけで **手に持っているスポーンエッグ**を制限に追加
- **全モブ削除 (MOBall)** / **アイテム削除** をワールドごとにワンクリックで切り替え
- **ボート** / **チェスト付きボート** を別々に ON/OFF（全ての木の種類・イカダに対応）
- スポーンはイベントで即キャンセル。定期スキャンとチャンク読み込み時のチェックで既存のエンティティも削除
- 全モブ削除の除外設定: アーマースタンド（既定）・名前付き・テイム済み・村人・スポーン理由
- `notentity.bypass` 権限（デフォルトは OP）を持つプレイヤーが捨てたアイテムは削除対象外
- `language.yml` による完全なメッセージカスタマイズ対応
- 旧バージョンの `config.yml` / `language.yml` を自動で更新

---

### コマンドと権限

#### コマンド

/notentity gui [world | all] - GUI で制限を管理 (省略時: all) /notentity list [world | all] - 現在の制限を表示 /notentity add [world | all] [entity] - 制限を追加 /notentity remove [world | all] [entity] - 制限を解除 /notentity reload - config.yml と language.yml を再読み込み

`add` / `remove` の省略形:

| コマンド | 動作 |
| --- | --- |
| `/notentity add` | **メインハンドに持っているスポーンエッグ**を `all` に追加 |
| `/notentity add <world>` | 持っているスポーンエッグを `<world>` に追加 |
| `/notentity add <entity>` | `<entity>` を `all` に追加（ワールド名として解決できない場合） |
| `/notentity add <world> <entity>` | `<entity>` を `<world>` に追加 |

`remove` も同様です。`<world>` は `all` または存在するワールド名（大文字小文字は区別しません）を指定してください。
`<entity>` は `ZOMBIE` のようなエンティティ名、または `ZOMBIE_SPAWN_EGG` のようなスポーンエッグ名です。
スポーンエッグの無いもの（`ARMOR_STAND`、`PRIMED_TNT`、`ITEM_FRAME` など）も名前で追加できます。

#### GUI の操作

- 先頭 4 スロットは **アイテム削除** / **全モブ削除** / **ボート削除** / **チェスト付きボート削除** の切り替えボタンです（クリック）。
- それ以外のスロットには、制限中のエンティティがスポーンエッグ（または代表アイテム）として並びます。
- **スポーンエッグを置く**（ドラッグ・Shift+クリック等）と制限に追加、**取り出す**と制限を解除します。
- 閉じると保存されます。エンティティではないアイテムは返却されます。
- 表示しきれない制限（50 件超、または区別できるアイコンが無いもの）は保持されます。`/notentity remove` で個別に解除できます。

#### 権限

| 権限 | 説明 | デフォルト |
| --- | --- | --- |
| `notentity.admin` | `/notentity` の全コマンドを使用 | OP |
| `notentity.bypass` | このプレイヤーが捨てたアイテムはアイテム削除の対象外 | OP |

---

### 設定ファイル

どちらも `plugins/NotEntity/` にあります。サーバーを動かしたまま編集し、`/notentity reload` で反映できます。
制限の内容そのものは `/notentity` コマンドや GUI での管理を推奨します（プラグインが `config.yml` に書き戻します）。

#### config.yml

```yml
# "all" は全ワールドに適用されます
worlds:
  world:
    item-delete: false
    mob-all: false
    boat: false          # 通常のボートを削除
    chest-boat: false    # チェスト付きボートを削除
    restricted-entities:
      - CREEPER
      - PHANTOM
  all:
    mob-all: false

# 読み込み済みエンティティの保険スキャン間隔（tick）。20 = 1秒、0 = 無効
# 新しいスポーンはイベントで即キャンセルされるため、短くする必要はありません
scan-interval-ticks: 100

# 「全モブ削除」の対象外にするエンティティ。
# restricted-entities に書いた種類は常に削除されます。
mob-all-exclusions:
  armor-stands: true
  named-entities: false   # 名前が付いているエンティティ（名札）
  tamed-entities: false   # テイム済みのペット
  villagers: false
  # これらの理由でスポーンしたものは対象外。例: [CUSTOM, SPAWNER_EGG]
  spawn-reasons: []

# プラグインが管理します。編集しないでください
config-version: 1

補足:

• ワールド名 all は全ワールドに適用されます。そのため all という名前のワールドは個別に設定できません。
• ワールドの設定と all の設定は合算され、どちらか一方で制限されていれば削除されます。
• restricted-entities に書いた種類は、mob-all-exclusions で除外対象になっていても削除されます。
• survival.nether のようにドットを含むワールド名にも対応しています。
• 解釈できないエンティティ名は、警告を出した上でそのまま保持されます（保存時に消えません）。/notentity remove <world> <名前> で削除できます。
• config.yml が壊れて読み込めない場合は、直前の設定を保持し、ファイルを上書きしません。
• エンティティ名は、サーバーの Minecraft バージョンのものを使用します。バージョン間で名前が変わったもの（MUSHROOM_COW / MOOSHROOM など）は自動で解決されます。

language.yml

すべてのメッセージは language.yml で変更できます。色コードは & を使用します。次のプレースホルダーが置換されます。

足りないキーは jar 同梱の既定値で補われるため、一部だけ書いたファイルでも動作します。lang-version はプラグインが管理します。 デフォルトは日本語です。全文は上の英語セクションの language.yml (default: Japanese) を参照してください。 英語に切り替えるには、language.yml (example: English) の内容に置き換えて /notentity reload を実行します。

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

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

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

旧形式の /notentity <world> も引き続き GUI を開けますが、正式な形式は /notentity gui <world> です。

1.2.0 の変更点

• 追加: ワールドごとの ボート削除 / チェスト付きボート削除 の切り替え（GUI、config.yml の boat / chest-boat、/notentity list で確認可能）
• GUI: 制限中のエンティティは 5 番目のスロットから並びます（先頭 4 つは切り替えボタン）
• コマンドと GUI を NotItem と同じ操作感に変更: gui / list / add / remove / reload、ヘルプ表示、手持ちのスポーンエッグの省略形
• 修正: 手書きした制限（スポーンエッグの無いエンティティ・解釈できない名前・GUI に収まらない件数）が GUI を閉じると消える問題
• 修正: ワールド名の大文字小文字で設定が分かれる問題、全モブ削除がアーマースタンドを消す問題
• 修正: 壊れた config.yml を上書きしてしまう問題、ドットを含むワールド名が正しく保存されない問題

対応環境

• サーバー: 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 以外のバージョンについては、実サーバーでの継続的な検証は行っていません。

注意

• 全モブ削除は、プレイヤーと mob-all-exclusions に該当するもの以外の全生物を削除します。restricted-entities に書いた種類は、除外対象でも常に削除されます。
• ボート / チェスト付きボートは独立して切り替えられ、全ての木の種類（1.20 以降はイカダも）が対象です。1.19 より前にはチェスト付きボートはありません。
• all ワールドに対して設定を行うと、サーバー内のすべてのワールドにその制限が適用されます。
• 複数の管理者が同じワールドの GUI を同時に開いた場合は、最後に閉じた人の内容が優先されます。
• GUI に置いたスポーンエッグは消費され、取り出したものは実際のアイテムになります（NotItem と同じ動作です）。

デフォルト言語：日本語（language.yml で自由に変更可能）