Compatibility
Minecraft: Java Edition
1.21.8–1.21.10
Platforms
Creators
Details
Licensed MIT
Published last week
Updated 2 weeks ago
Overview
S-PlayerWarps is a simple Paper plugin that lets players create personal warps and teleport to them.
Features
- Reload the plugin directly in-game.
- Teleport with optional delay and cancel-on-move.
- Customizable messages (english.yml & german.yml, you can add more).
- Sound effects for teleportation events.
- Cancel teleportation due to movement.
- Configurable GUIs.
- Customizable player warps (displayname, material).
- Tracking visits and unique visits.
- More features in development ...
Commands
- /s-playerwarps about - Receive information about the plugin (name, version & author).
- /s-playerwarps reload - Reload the plugin to update config files.
- /playerwarp - Opens the menu if the player has permission, else it will show the usage message.
- /playerwarp menu - Opens the playerwarps menu.
- /playerwarp create <identifier> - Creates a playerwarp with the given identifier.
- /playerwarp teleport <identifier> - Teleports to the givien playerwarp.
Permissions
- s-playerwarps.admin.about = Allows access to the about command.
- s-playerwarps.admin.reload = Allows access to the reload command.
- s-playerwarps.admin.notifyUpdate = Allows receiving update notifications. Player Permissions
- s-playerwarps.commands.playerwarp.use = Allows access to the playerwarp command.
- s-playerwarps.commands.playerwarp.help = Allows access to the help command.
- s-playerwarps.commands.playerwarp.create = Allows creating player warps.
- s-playerwarps.commands.playerwarp.teleport = Allows teleporting to player warps.
- s-playerwarps.commands.playerwarp.menu = Allows opening the player warps menu.
Documentation
GitBook docu: Link
Configs
View config.yml
# This plugin utilizes MiniMessage for messages.
# For more information, visit https://docs.adventure.kyori.net/minimessage.html
file-version: 1
# The prefix before every message
prefix: "<#D1E332><b>S-PlayerWarps</b> <dark_gray>⚡ <gray>"
# The messages file to use
langFile: 'english'
# Settings for the update checker
updateChecker:
# Send a message to the console when a new version is available
consoleMessage: true
# Send a message to the player when a new version is available
# This requires the permission 's-playerwarps.admin.notifyUpdate' or to be an OP
playerMessage: true
# Settings for data saving
saving:
# Whether to save player warps asynchronously
async: true
# The delay between autosaves in seconds
# [ Default = 1200 (20 minutes) ]
delay: 1200
# Settings for all sounds
sounds:
teleportSound:
# Whether to play a sound when teleporting
enabled: true
# The sound to play when teleporting
sound: 'ENTITY.ENDERMAN.TELEPORT'
# The volume of the sound
volume: 1.0
# The pitch of the sound
pitch: 1.0
delaySound:
# Whether to play a sound during the teleportation delay
enabled: true
# The sound to play during the teleportation delay
sound: 'BLOCK.NOTE_BLOCK.BASS'
# The volume of the sound
volume: 1.0
# The pitch of the sound
pitch: 1.0
cancelSound:
# Whether to play a sound if the teleportation is canceled
enabled: true
# The sound to play if the teleportation is canceled
sound: 'ENTITY.VILLAGER.NO'
# The volume of the sound
volume: 1.0
# The pitch of the sound
pitch: 1.0
# Settings for player warps
playerwarps:
# The maximum amount of player warps a player can create
# Set to 0 to make permission based (max. 100) | Set to -1 for unlimited
# Permission: s-playerwarps.limit.<amount>
maxWarpsPerPlayer: 5
# The default icon for player warps (Material name)
defaultWarpIcon: 'COMPASS'
# The maximum length for warp display names
displayNameMaxLength: 40
# Settings for warp identifiers
# I would recommend to NOT change these settings unless you know what you're doing; This does not effect the display name
identifier:
# The regex pattern that warp identifiers must match
regex: '^[A-Za-z0-9_]+$'
# The minimum length for warp identifiers
minLength: 4
# The maximum length for warp identifiers
maxLength: 16
# Settings for teleportation
teleportation:
# The delay before teleporting (in seconds)
delay:
# Whether to enable a delay before teleporting
enabled: true
# The length of the delay in seconds
delay: 3
# Whether to cancel the teleportation if the player moves
cancelOnMove: true
View english.yml
# This plugin utilizes MiniMessage for messages.
# For more information, visit https://docs.adventure.kyori.net/minimessage.html
file-version: 1
# General messages
general:
noPlayer: "<gray>You <red>must be a player<gray> to execute this command!"
noPerms: "<gray>You <red>do not have permission<gray> to execute this command!"
playerNotFound: "<gray>The given player <red>could not be found<gray>!"
# Other messages
other:
updateChecker: "<gray>An <yellow>update <gray>is available! You are using version <red>v%current-version%<gray>, the latest version is <green>%latest-version%<gray>!"
# Command messages
commands:
# Messages for the /s-playerwarps command (main plugin command)
s-playerwarps:
usage: "<gray>Please use <red>/s-playerwarps <about/reload><gray>!"
about: "<gray>S-PlayerWarps v%version% <dark_gray>- <gray>%authors%"
reload:
reloading: "<yellow>Reloading <gray>S-PlayerWarps..."
success: "<green>Successfully reloaded <gray>S-PlayerWarps! <dark_gray>(%time%ms)"
error: "<gray>An <red>error occurred <gray>while reloading S-PlayerWarps! Check the console for details."
# Messages for the /playerwarp command
playerwarp:
usage: "<gray>Please use <red>/playerwarp <create/teleport> <identifier><gray>!"
create:
success: "<gray>The player warp <white>%warp% <gray>has <green>successfully been created<gray>!"
alreadyExists: "<gray>A player warp with the identifier <white>%warp% <red>already exists<gray>!"
identifierRegex: "<gray>The warp identifier <white>%warp% <gray>contains <red>invalid characters<gray>! Please use only letters, numbers and underscores."
identifierLength: "<gray>The warp identifier <white>%warp% <gray>is <red>too long or too short<gray>! Please use a identifier between <red>4 and 16 <gray>characters long."
maxWarpsReached: "<gray>You have reached the <red>maximum amount of player warps <gray>you can create!"
teleport:
teleporting: "<gray>Teleportation starting ..."
success: "<gray>You have been teleported to player warp <white>%warp%<gray>!"
notFound: "<gray>The player warp <white>%warp% <gray>could <red>not be found<gray>!"
canceled: "<gray>Teleportation <red>canceled<gray> due to movement!"
# Dialog texts
dialogs:
displayname:
title: "<yellow><b>Change Displayname"
texts:
- "<white>Enter a new displayname for your player warp:"
buttons:
confirm: "<green>Confirm"
cancel: "<red>Cancel"
delete:
title: "<red><b>Delete Player-Warp"
texts:
- "<white>Are you sure?"
- "<white>This action <red><u>cannot be undone</u><white>."
buttons:
confirm: "<green>Confirm"
cancel: "<red>Cancel"
icon:
title: "<red><b>Change Icon"
texts:
- "<white>Enter the name of the material you want to use for your player warp (e.g. 'Oak Log'):"
buttons:
confirm: "<green>Confirm"
cancel: "<red>Cancel"
messages:
invalidMaterial: "<gray>The material you entered <red>is invalid<gray>! Please enter a valid material name."
create:
title: "<green><b>Create Player-Warp"
texts:
- "<white>Enter a unique identifier for your new player warp:"
- "<gray>Note: The identifier may only contain letters, numbers and underscores and must be between 4 and 16 characters long."
buttons:
confirm: "<green>Confirm"
cancel: "<red>Cancel"
View german.yml
# This plugin utilizes MiniMessage for messages.
# For more information, visit https://docs.adventure.kyori.net/minimessage.html
file-version: 1
# Generelle Nachrichten
general:
noPlayer: "<gray>Dies können <red>nur Spieler<gray> ausführen!"
noPerms: "<gray>Du hast <red>keine Berechtigung<gray> für diesen Befehl!"
playerNotFound: "<gray>Der angegebene Spieler <red>konnte nicht gefunden<gray> werden!"
# Other messages
other:
updateChecker: "<gray>Es ist ein <yellow>Update verfügbar<gray>! Die momentane Version ist die <red>v%current-version%<gray>, die neuste Version ist die <green>%latest-version%<gray>!"
# Befehlsnachrichten
commands:
# Nachrichten für den /s-playerwarps Befehl (Hauptbefehl des Plugins)
s-playerwarps:
usage: "<gray>Bitte nutze <red>/s-playerwarps <about/reload><gray>!"
about: "<gray>S-PlayerWarps v%version% <dark_gray>- <gray>%authors%"
reload:
reloading: "<gray>S-PlayerWarps <yellow>wird neugeladen<gray>..."
success: "<gray>S-PlayerWarps wurde <green>erfolgreich neugeladen<gray>! <dark_gray>(%time%ms)"
error: "<red>Fehler beim Neuladen <gray>von S-PlayerWarps! Überprüfe die Konsole für Details."
playerwarp:
usage: "<gray>Bitte nutze <red>/playerwarp <create/teleport> <Identifier><gray>!"
create:
success: "<gray>Der Spieler-Warp <white>%warp% <gray>wurde <green>erfolgreich erstellt<gray>!"
alreadyExists: "<gray>Ein Spieler-Warp mit der ID <white>%warp% <red>existiert bereits<gray>!"
identifierRegex: "<gray>Die Warp-ID <white>%warp% <gray>enthält <red>ungültige Zeichen<gray>! Bitte nutze nur Buchstaben, Zahlen und Unterstriche."
identifierLength: "<gray>Die Warp-ID <white>%warp% <gray>ist <red>zu lang oder zu kurz<gray>! Bitte nutze eine ID mit einer Zeichenlänge zwischen <red>4 und 16<gray>."
maxWarpsReached: "<gray>Du hast die <red>maximale Anzahl an Spieler-Warps <gray>erreicht, die du erstellen kannst!"
teleport:
teleporting: "<gray>Teleportation wird gestartet ..."
success: "<gray>Du wurdest zum Spieler-Warp <white>%warp% <gray>teleportiert!"
notFound: "<gray>Der Spieler-Warp <white>%warp% <gray>konnte <red>nicht gefunden<gray> werden!"
canceled: "<gray>Die Teleportation wurde aufgrund von Bewegung <red>abgebrochen<gray>!"
# Dialog texts
dialogs:
displayname:
title: "<yellow><b>Anzeigenamen ändern"
texts:
- "<white>Gib einen neuen Anzeigenamen für deinen Spieler-Warp ein:"
buttons:
confirm: "<green>Bestätigen"
cancel: "<red>Abbrechen"
delete:
title: "<red><b>Spieler-Warp löschen"
texts:
- "<white>Bist du sicher?"
- "<white>Diese Aktion <red><u>kann nicht rückgängig gemacht werden</u><white>."
buttons:
confirm: "<green>Bestätigen"
cancel: "<red>Abbrechen"
icon:
title: "<red><b>Icon ändern"
texts:
- "<white>Gib den Namen des Materials (auf Englisch) ein, welches du für dein Spieler-Warp verwenden möchtest (z.B. 'Oak Log'):"
buttons:
confirm: "<green>Bestätigen"
cancel: "<red>Abbrechen"
create:
title: "<green><b>Spieler-Warp erstellen"
texts:
- "<white>Gib den Identifier für deinen neuen Spieler-Warp ein:"
- "<gray>Hinweis: Der Identifier darf nur Buchstaben, Zahlen und Unterstriche enthalten und muss zwischen 4 und 16 Zeichen lang sein."
buttons:
confirm: "<green>Bestätigen"
cancel: "<red>Abbrechen"
Contact
If you encounter any issues or bugs, or have a request for a new feature, please contact me via Discord or join my Discord-Server.
My discord-name is Losterixx.
My Discord-Server: Link



