» Introduction: RayGuide is a powerful and immersive player-guiding plugin for Minecraft. It allows players to follow custom-recorded paths using ghostly NPCs or mobs, synchronized with dynamic holographic text shown through invisible ArmorStands. Missions are entirely player-personalized, configurable, and saved for replay.
Players can create cinematic guides, epic quests, or tutorial paths that only they can see — all handled in an elegant and intuitive way.
» Features ✔️ Create NPCs or mobs (ghost-like guides) using Citizens or Minecraft entities ✔️ Record and save paths with precision (including jumps and pauses) ✔️ Invisible holograms (ArmorStands) that display text synced with movement ✔️ Per-player visibility — only the mission starter sees the guide ✔️ Full config.yml for customization (text speed, distances, delay, etc.) ✔️ Save missions in .yml format for reuse and sharing ✔️ Integrated permissions system ✔️ Repeatable or one-time missions ✔️ Support for Paper/Spigot 1.21+, built with JDK 22 ✔️ Lightweight, modular, and efficient ✔️ Easy-to-use command system
» Commands /rayguide create <GuideName> npc|mob <skinOrType> per-player=yes|no ➤ Creates a new guide. Choose between a Citizens NPC or a regular Minecraft mob. Set the appearance (skin name or entity type) and define if the guide should be visible only to the player or to everyone.
/rayguide config <GuideName> ➤ Opens the configuration menu for that guide. You can adjust settings like delay between steps, movement distance, and whether the guide repeats.
/rayguide text <GuideName> <idtext> "<text>" sec=<time> repeat=yes|no ➤ Adds a holographic floating text to the mission. Set a unique ID, the text message, duration in seconds, and whether it should repeat.
/rayguide save <GuideName> ➤ Saves the guide with all its configuration, path, and texts into a .yml file for reuse or sharing.
/rayguide delete <GuideName> ➤ Permanently deletes the guide. This action removes the mission and all its data.
/rayguide start <GuideName> ➤ Starts the mission. If it's set to per-player, only the player who runs the command will see the mob/NPC and text effects.
/rg or /rayguide or /rayguide help to see the commands in-game!
» Example usage >Create a guide Use the command: /rayguide create TutorialGuide npc Steve per-player=yes This will create a ghost NPC with Steve’s skin, visible only to the player who starts the mission.
>Configure behavior Run: /rayguide config TutorialGuide Use the in-game GUI to adjust step delay, path distance, repeat options, and other mission parameters.
>Add holographic text Add floating text like this: /rayguide text TutorialGuide intro1 "&eWelcome to the tutorial!" sec=3 repeat=no This creates a 3-second message displayed at the right moment in the mission.
>Save your mission Save all progress using: /rayguide save TutorialGuide This stores the guide in your plugin folder for later use or edits.
>Start the mission Begin the guide by typing: /rayguide start TutorialGuide The ghost guide will move along its path, showing texts to only you (if per-player is enabled).
» Permission: rayguide.use: description: Use RayGuide commands default: op
IMPORTANT
THIS PLUGINS NEEDS THE NEXT PLUGINS TO WORK:
CITIZENS DECENTHOLOGRAMS
Also, Don't forget to save with /rayguide save <GuideName>, or your path will be lost.