# SMP Position Saver<\/p>\n
A Bukkit plugin for Minecraft 1.21.8 that saves and restores player positions in SMP worlds.<\/p>\n
## Features<\/p>\n
– **Auto save**: Saves player position when they leave an SMP world
\n– **Auto restore**: Restores the last saved position when a player enters an SMP world
\n– **Flexible configuration**: Configurable list of worlds treated as SMP
\n– **Multi-world support**: Handles multiple SMP worlds at once
\n– **YAML storage**: Positions stored in `positions.yml`<\/p>\n
## Installation<\/p>\n
1. Compile the plugin with Maven:
\n “`bash
\n mvn clean package
\n “`<\/p>\n
2. Copy the generated JAR from `target\/` to your server’s `plugins\/` folder.<\/p>\n
3. Restart the server or reload the plugins.<\/p>\n
## Configuration<\/p>\n
The `config.yml` file will be generated automatically in the plugin folder:<\/p>\n
“`yaml
\n# SMP worlds configuration
\nsmp-worlds:
\n – “world”
\n – “world_nether”
\n – “world_the_end”
\n – “survival”
\n – “survival_nether”
\n – “survival_the_end”<\/p>\n
# Customizable messages
\nmessages:
\n position-saved: “\u00a7aYour position has been saved in {world}!”
\n position-restored: “\u00a7aYou have been teleported to your last position in {world}!”
\n no-position-saved: “\u00a7cNo saved position for this world.”
\n config-reloaded: “\u00a7aConfiguration reloaded successfully!”<\/p>\n
# Options
\noptions:
\n save-on-quit: true
\n restore-on-join: true
\n clear-on-death: true
\n debug: false
\n # Datapack functions executed when entering\/exiting an SMP world
\n entry-function: “datapack:functions\/enter_smp”
\n exit-function: “datapack:functions\/exit_smp”
\n“`<\/p>\n
### SMP worlds configuration<\/p>\n
Add or remove worlds in the `smp-worlds` section to define which worlds belong to the SMP group.<\/p>\n
– Names may be exact or use the wildcard `*`. For instance `world_*` will match `world_1`, `world_nether`, etc.<\/p>\n
### Options<\/p>\n
– `save-on-quit`: Save the position when the player leaves the server
\n– `restore-on-join`: Restore the position when the player joins the server
\n– `clear-on-death`: Remove saved coordinates when a player dies in an SMP world
\n– `debug`: Enable debug logging<\/p>\n
## How it works<\/p>\n
### When a player enters an SMP world:<\/p>\n
1. The plugin checks if a position was saved for that player in this world
\n2. If so, the player is teleported to their last saved position
\n3. Otherwise a message informs them that no position is available<\/p>\n
### When a player leaves an SMP world:<\/p>\n
1. The plugin automatically saves the player’s current position
\n2. Coordinates (x, y, z), orientation (yaw, pitch) and world are recorded
\n3. A message confirms the save<\/p>\n
### Data storage<\/p>\n
Positions are saved in `plugins\/SMPPositionSaver\/positions.yml` with this structure:<\/p>\n
“`yaml ## Permissions<\/p>\n – `smppositionsaver.use`: Allows use of the position saving system (default: true)<\/p>\n ## Commands<\/p>\n – `\/smp`: Teleports the player to the SMP coordinates defined in the configuration. This command isn’t required for normal operation but can be useful after editing `config.yml` without restarting the server.<\/p>\n ## Compatibility<\/p>\n – **Minecraft**: 1.21.8 ## Development<\/p>\n The plugin is structured with the following components:<\/p>\n – `SMPPositionSaver`: Main plugin class ## Support<\/p>\n For any questions or issues, please check the server logs or enable debug mode in the configuration.<\/p>\n","protected":false},"excerpt":{"rendered":" SMP Position Saver \u2013 lightweight Bukkit plugin that auto\u2011saves\/restores player locations in configurable SMP worlds (YAML storage, wildcard support, optional commands).<\/p>\n","protected":false},"featured_media":23958,"template":"","meta":{"_minecraft_slug":"smppositionsaver","_minecraft_project_id":"SrmhlBc8","_minecraft_author":"fox3000foxy","_minecraft_license":"Apache-2.0","_minecraft_downloads":33,"_minecraft_follows":1,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"smppositionsaver.zip","_minecraft_size_bytes":19710,"_minecraft_version_count":1,"_minecraft_updated_at":"2026-05-15T21:57:53.625220Z","_minecraft_date_created":"2026-02-28T02:47:14.965598Z","_minecraft_date_modified":"2026-02-24T13:25:45.018146Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/smppositionsaver","_minecraft_icon_attachment_id":23958,"_minecraft_imported_at":"2026-06-08T15:06:42+00:00","_minecraft_import_hash":"bef496d981d7bda5b1681438df7ad46b","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[124,127,128,129],"mod_loader":[130,132,133,134],"minecraft_version":[62,37,40,41,73,74,38,78,79,80,81,82],"class_list":["post-144398","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-bukkit","mod_category-paper","mod_category-purpur","mod_category-spigot","mod_loader-bukkit","mod_loader-paper","mod_loader-purpur","mod_loader-spigot","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9"],"yoast_head":"\n
\nplayers:\n
\n
\n x: 123.45
\n y: 64.0
\n z: -456.78
\n yaw: 90.0
\n pitch: 0.0
\n“`<\/p>\n
\n– `\/smp reload`: Reloads the configuration file; requires permission `smp.reload` (op by default).<\/p>\n
\n– **API**: Spigot\/Paper 1.21+
\n– **Java**: 21+<\/p>\n
\n– `ConfigManager`: Configuration manager
\n– `PositionManager`: Player position manager
\n– `PlayerWorldChangeListener`: Listener for world change events
\n– `PlayerPosition`: Model representing a saved position<\/p>\n