Code (Text):
## Compatibility
Minecraft Versions: 1.20, 1.20.1, 1.20.2, 1.20.3, 1.20.4, 1.20.5, 1.20.6, 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4+
Server Software: Paper, Spigot, Bukkit, Purpur, Pufferfish, and other Bukkit-based servers
Java Version: Requires Java 17 or higher (plugin compiled with Java 21)
# PhantomSetings - Advanced Phantom Management
**Solve phantom spawning issues on multiplayer servers!**Click to expand...
## What does this plugin do?
PhantomSetings is an intelligent phantom management plugin designed specifically for multiplayer survival servers. It solves the frustrating problem where phantoms continue attacking well-rested players after spawning for someone else.Click to expand...
### The Problem on Multiplayer Servers
In vanilla Minecraft, phantoms spawn above players who haven't slept for 3+ in-game days. Once spawned, these phantoms persist even after the original target uses a bed or dies, attacking nearby players regardless of their rest status. On single-player, this isn't an issue since you can skip the night. However, on multiplayer servers, sleeping doesn't remove existing phantoms, forcing innocent players to endure attacks until sunrise.Click to expand...
### The Solution
PhantomSetings intelligently manages phantom behavior:
- ✅ **Phantoms ignore recently-rested players** (configurable protection period)
- ✅ **Automatic phantom removal** when players sleep or die
- ✅ **Permission-based immunity** for specific players
- ✅ **Fully customizable** protection periods and behavior
- ✅ **Statistics tracking** for server admins
- ✅ **Multi-language support** (English & Russian included)Click to expand...
## Features
### Smart Phantom Management
- **Intelligent Targeting**: Phantoms won't target players who have used a bed within the last 3 Minecraft days (configurable: `disallow-targeting-for`)
- **Automatic Cleanup**: Removes phantoms when players enter beds or die (configurable)
- **Spawn Prevention**: Blocks phantom spawns near protected players with permission
- **Customizable Radius**: Set how far the plugin searches for phantoms (default: 128 blocks)Click to expand...
### Permission System
- `phantomsetings.disallowspawn` - Prevents phantoms from spawning near this player
- `phantomsetings.ignore` - Makes phantoms completely ignore this player
- `phantomsetings.reload` - Allows reloading configuration
- `phantomsetings.*` - Grants all permissionsClick to expand...
### Commands
- `/phantomsetings` (aliases: `/ps`, `/phantom`, `/phantoms`) - Main command
- `/ps reload` - Reload configuration without restart
- `/ps info` - View your protection status and nearby phantoms
- `/ps stats` - See global and personal phantom removal statisticsClick to expand...
The plugin offers extensive customization:
Code (YAML):
phantom-settings:
remove-targeting-rested : true # Remove phantoms targeting rested players
remove-when-sleeping : false # Remove phantoms when entering bed
remove-on-death : true # Remove phantoms on player death
disallow-targeting-for : 72000 # Protection duration (72000 ticks = 3 MC days)
phantom-search-radius : 128 # Search radius in blocks
remove-all-on-sleep : false # Remove ALL nearby phantoms when sleeping
### Player Notifications
- Configurable notifications when phantoms are removed
- Choose between chat messages or actionbar
- Optional sound effects (customizable type, volume, pitch)
- All messages fully translatableClick to expand...
### Statistics Tracking
- Total phantoms removed globally
- Per-player phantom removal count
- Total rest events recorded
- Individual player protection statusClick to expand...
## Installation
1. Download `PhantomSetings.jar`
2. Place in your server's `plugins` folder
3. Restart your server
4. Configure in `plugins/PhantomSetings/config.yml`
5. Use `/ps reload` to apply changesClick to expand...
### Strict Protection (Recommended)
Code (YAML):
phantom-settings:
remove-targeting-rested : true
remove-when-sleeping : true
remove-on-death : true
disallow-targeting-for : 72000
### Vanilla-Like (Minimal Changes)
Code (YAML):
phantom-settings:
remove-targeting-rested : false
remove-when-sleeping : false
remove-on-death : true
disallow-targeting-for : 72000
### Custom Protection Period
Code (YAML):
phantom-settings:
disallow-targeting-for : 144000 # 6 Minecraft days instead of 3
## Language Support
Built-in languages:
- English (`messages_en.yml`)
- Russian (`messages_ru.yml`)
Change language in `config.yml`:
```yaml
language: en # or 'ru' for Russian
```
All messages are fully customizable - edit the language files to personalize text.
## Performance
PhantomSetings is designed for efficiency:
- Asynchronous data saving
- Optimized phantom detection
- Minimal server impact
- Works on servers with hundreds of players
## Support & Links
- **GitHub**: https://github.com/igalexor/PhantomSetings
- **Issues**: https://github.com/igalexor/PhantomSetings/issues
- **Wiki**: https://github.com/igalexor/PhantomSetings/wiki
## Developer Information
- **Author**: igalexor
- **License**: MIT
## Why Choose PhantomSetings?
- **Purpose-Built**: Specifically designed to solve multiplayer phantom issues
- **Highly Configurable**: Customize every aspect to fit your server
- **Multi-Language**: Built-in internationalization support
- **Statistics**: Track plugin effectiveness
- ⚡ **Performance**: Lightweight and efficient
- **Open Source**: Free and transparent
- **Active Development**: Regular updates and bug fixes
## Credits
Inspired by the community's need for better phantom management on multiplayer servers. Special thanks to all server owners and players who provided feedback during development.
---
**Make your multiplayer server phantom-friendly today!**
*Download PhantomSetings and give your players the peaceful nights they deserve.*
Quick facts
- Edition: Minecraft Java
- File type: .jar
- Minecraft versions listed: 1.20, 1.21
- How to install: Install the matching mod loader (Forge, Fabric or NeoForge) for your Minecraft version. → Download the .jar. → Put it in the .minecraft/mods folder and launch that loader profile.
- Where to get it: Opens on Spigot — not every file is mirrored on our own servers.
Install steps are the general flow for this file type — How to install Minecraft Java mods & modpacks walks through it step by step.
PhantomSetings is a free Minecraft Java mod. Compatible with Minecraft 1.20, 1.21. Downloaded 12 times (via Spigot). Download it and open it directly in the game.