# RandomSPAWNZ

**RandomSPAWNZ** is a lightweight, highly configurable Minecraft plugin that teleports players to random, safe locations when they join your server, creating a unique and unpredictable experience for everyone.

## ✨ Features

- **Random Spawning**: Players will spawn at random locations within configurable X/Z boundaries
- **Safety First**: Advanced safety checks ensure players never spawn in dangerous areas
- **Multi-world Support**: Choose specific worlds for random spawns or use your default world
- **First-Join Option**: Can be configured to only apply to new players
- **Welcome Messages**: Customizable welcome messages with color code support
- **Simple Commands**: Easy-to-use admin commands for plugin management
- **Performance Optimized**: Designed to be lightweight with minimal server impact

## Commands

- `/randomspawnz` - Shows plugin information
- `/randomspawnz reload` - Reloads the plugin configuration
- `/randomspawnz info` - Displays detailed plugin settings
- `/randomspawnz spawn` - Manually teleports yourself to a random location

## Configuration

RandomSPAWNZ is designed to be simple to set up but offers deep customization for server owners who want more control:

```yaml
# If true, the plugin will only use worlds specified in the 'allowed-worlds' list
use-custom-worlds: false

# List of worlds where random spawns can occur
allowed-worlds:
- world
- world_nether
- world_the_end

# The range in which players will be randomly spawned
spawn-range:
min-x: -1000
max-x: 1000
min-z: -1000
max-z: 1000

# Maximum number of attempts to find a safe location
max-teleport-attempts: 50

# If true, will only teleport players to safe locations
safe-teleport: true

# If true, will only teleport players on their first join
teleport-on-first-join-only: false

# If true, will send a welcome message after teleporting
send-welcome-message: true

# Welcome message (supports color codes with &)
welcome-message: "&6Welcome to the server! &aYou've been randomly spawned!"
```

## Why RandomSPAWNZ?

In vanilla Minecraft and most servers, players spawn at the same location. This can lead to:
- Overcrowding in spawn areas
- Resource depletion near spawn
- Easy griefing of new players
- Predictable gameplay experiences

RandomSPAWNZ solves these problems by dispersing players throughout your world, creating unique journeys for each player and encouraging exploration from the very beginning.

## Use Cases

- **Survival Servers**: Create challenging survival experiences where every player starts their journey from a different location
- **SMP Servers**: Encourage organic community building as players find each other in the wild
- **Adventure Maps**: Randomize starting points for custom adventure experiences
- **Mini-games**: Use as a starting mechanism for scatter-style games

## Installation

1. Download the latest version of RandomSPAWNZ
2. Place the .jar file in your server's plugins folder
3. Restart your server
4. Edit the generated config.yml to customize the plugin to your needs
5. Use `/randomspawnz reload` to apply changes

## ️ Compatibility

- Works with Paper, Spigot, and Bukkit
- Minecraft versions 1.20~+
- Compatible with most world management plugins

## Permissions

- `randomspawnz.admin` - Allows access to all RandomSPAWNZ commands

---