SMPPositionSaver

SMP Position Saver

A Bukkit plugin for Minecraft 1.21.8 that saves and restores player positions in SMP worlds.

Features

- YAML storage: Saves player position when they leave an SMP world - YAML storage: Restores the last saved position when a player enters an SMP world - YAML storage: Configurable list of worlds treated as SMP - YAML storage: Handles multiple SMP worlds at once - YAML storage: Positions stored in `positions.yml`

Installation

1. Compile the plugin with Maven: ```bash mvn clean package ```

2. Copy the generated JAR from `target/` to your server's `plugins/` folder.

3. Restart the server or reload the plugins.

Configuration

The `config.yml` file will be generated automatically in the plugin folder:

```yaml

SMP worlds configuration

smp-worlds: - "world" - "world_nether" - "world_the_end" - "survival" - "survival_nether" - "survival_the_end"

Customizable messages

messages: position-saved: "§aYour position has been saved in {world}!" position-restored: "§aYou have been teleported to your last position in {world}!" no-position-saved: "§cNo saved position for this world." config-reloaded: "§aConfiguration reloaded successfully!"

Options

options: save-on-quit: true restore-on-join: true clear-on-death: true debug: false

Datapack functions executed when entering/exiting an SMP world

entry-function: "datapack:functions/enter_smp" exit-function: "datapack:functions/exit_smp" ```

SMP worlds configuration

Add or remove worlds in the `smp-worlds` section to define which worlds belong to the SMP group.

- Names may be exact or use the wildcard `*`. For instance `world_*` will match `world_1`, `world_nether`, etc.

Options

- `save-on-quit`: Save the position when the player leaves the server - `restore-on-join`: Restore the position when the player joins the server - `clear-on-death`: Remove saved coordinates when a player dies in an SMP world - `debug`: Enable debug logging

How it works

When a player enters an SMP world:

1. The plugin checks if a position was saved for that player in this world 2. If so, the player is teleported to their last saved position 3. Otherwise a message informs them that no position is available

When a player leaves an SMP world:

1. The plugin automatically saves the player's current position 2. Coordinates (x, y, z), orientation (yaw, pitch) and world are recorded 3. A message confirms the save

Data storage

Positions are saved in `plugins/SMPPositionSaver/positions.yml` with this structure:

```yaml players: <player-uuid>: <world-name>: x: 123.45 y: 64.0 z: -456.78 yaw: 90.0 pitch: 0.0 ```

Permissions

- `smppositionsaver.use`: Allows use of the position saving system (default: true)

Commands

- `/smp`: Teleports the player to the SMP coordinates defined in the configuration. - `/smp reload`: Reloads the configuration file; requires permission `smp.reload` (op by default).

This command isn't required for normal operation but can be useful after editing `config.yml` without restarting the server.

Compatibility

- Java: 1.21.8 - Java: Spigot/Paper 1.21+ - Java: 21+

Development

The plugin is structured with the following components:

- `SMPPositionSaver`: Main plugin class - `ConfigManager`: Configuration manager - `PositionManager`: Player position manager - `PlayerWorldChangeListener`: Listener for world change events - `PlayerPosition`: Model representing a saved position

Support

For any questions or issues, please check the server logs or enable debug mode in the configuration.