MMOtele | Cinematic Teleport Loading Screen

Full-Screen Loading Screen
A cinematic 16:9 loading screen shown when players teleport, respawn, or travel through configured portals.

MMORPG-Style Progress Bar
A custom graphical loading bar with configurable frame and fill colors. Players can pick their own bar color with /mmotele barcolor.


Auto Resource Pack Generator
MMOtele builds its own resource pack automatically — backgrounds, custom fonts, progress bar textures, animations and music. No manual pack editing.

Does Not Replace Your Server Pack
The generated pack is applied on top of your existing server pack, so your current textures stay intact.

Teleport Plugin Support
Hooks into popular teleport plugins: EssentialsX, CMI and HuskHomes.

Command-Based Trigger System
Only commands you register (warp, home, rtp, spawn, tpa…) trigger the screen — preventing false triggers from anticheat, minigames or admin teleports.

Menu & Custom Plugin Support
Call /mmotele trigger before teleporting a player from DeluxeMenus, NPCs, portals or your own systems:
Cinematic Show Mode
Display the loading screen without teleporting — perfect for cutscenes, dungeon intros, server events and announcements.

Animated Backgrounds
Supports animated GIF files and PNG frame folders. Build portal animations, fantasy scenes, or any custom loading effect.

VIP / Donor Backgrounds
Give donors exclusive backgrounds per theme with vip-images and the mmotele.vip permission.
Background Music

Drop in .ogg files and assign different tracks to different themes.

PlaceholderAPI Support
Tips, titles and bossbar text support placeholders such as %player_name% and %server_online%.

Fallback Mode
Players who decline the resource pack, fail the download, or join from Bedrock via Geyser get a clean text + bossbar fallback instead of broken characters.

Player Freeze During Loading
Optionally block movement, interaction and damage while the screen is up, for a cleaner cinematic.

Multi-Language
Ships with English and Vietnamese language files. Add or edit your own freely.

• Server: Paper 1.21+
• Java: 21+
• Internet access: required — the plugin validates your license key online
• Optional: ProtocolLib, EssentialsX, CMI, HuskHomes, PlaceholderAPI, Geyser

1. Drop the jar into plugins/ and start the server once — it creates plugins/MMOtele/.
2. Open plugins/MMOtele/key.yml and paste your purchased license key.
3. (Optional) Put your own loading images into plugins/MMOtele/images/. Two sample backgrounds and two animated GIFs are included.
4. Set your public resource pack address in config.yml. MMOtele hosts the pack itself — make sure the chosen port is reachable from the internet, or host the pack on your own web server.
5. Run /mmotele reload to reload the config and generate the pack.

Alias: /loadingscreen
Players

• /mmotele — show help
• /mmotele barcolor <#hex|color|reset> — change your loading bar color

Admins

• /mmotele reload — reload config and regenerate the pack
• /mmotele generatepack — generate the resource pack
• /mmotele debug — check pack and hook status
• /mmotele trigger <player> <theme> — arm a player for their next teleport
• /mmotele show <player|all> <seconds> — show the cinematic without teleporting

✦ Permissions

• mmotele.admin — access admin commands (default: op)
• mmotele.trigger — use the trigger command (default: op)
• mmotele.barcolor — let players change their bar color (default: true)
• mmotele.bypass — never see the loading screen (default: false)
• mmotele.vip — see the VIP backgrounds of a theme (default: false)

✦ License Terms — please read before buying

• This plugin requires a license key. One key activates one server.
• On first startup the key locks to your server's public IP. If you change host or IP, contact me and I will unlock it for you — free of charge.
• Your server needs internet access to validate the key. Short outages are fine (the plugin keeps running on a temporary grace period), but a permanently offline server is not supported.
• Do not share, resell or redistribute the plugin or your key. Leaked keys are revoked.
• Chargebacks / refunds after the key has been activated are not accepted.