MYTHICGHOULPLUGIN FORGE
Home / Resources / MythicMaps
MythicMaps icon
Server Exclusive

MythicMaps

Image maps, GIF playback, floating displays and transparent sprite art.

Server exclusive
—Spigot downloads
—Modrinth downloads
Private buildRelease status
1.0.0Current version
—Last public update

Full overview

Image maps, GIF playback, floating displays and transparent sprite art.

MythicMaps turns external images into several kinds of in-world media. Traditional map art, animated maps, floating displays and transparent sprite layouts are managed through one project.

It is suited to spawn artwork, signs, story displays, event boards and decorative installations.

Best suited toCreative hubs, RPG worlds and community servers that want custom visual media embedded into builds.

How it works

Import media, choose a renderer and place the result in the world

Images are placed in the configured images directory and converted into map, display or sprite records.

Dedicated renderers manage static images and GIF frames while managers preserve installations and enforce practical size and entity limits.

Administration

Configuration and live-server use

Commands, permissions, configuration files and architecture are documented below from the supplied project.

CompatibilityPaper/Spigot 1.20+IntegrationsNo required integrationsVersion1.0.0

Feature breakdown

Everything included in MythicMaps

Feature coverage is backed by the supplied project source.

✓

Static image maps

Implemented by the supplied source project and expanded in the source reference below.

✓

Animated GIF maps

Implemented by the supplied source project and expanded in the source reference below.

✓

Floating display records

Implemented by the supplied source project and expanded in the source reference below.

✓

Transparent sprite engine

Implemented by the supplied source project and expanded in the source reference below.

✓

Fit modes and scale controls

Implemented by the supplied source project and expanded in the source reference below.

✓

Persistent data

Implemented by the supplied source project and expanded in the source reference below.

Getting started

Installation and rollout

Review the source-verified reference before production deployment.

  1. 1

    Place supported files in the images folder.

  2. 2

    Review wall, GIF, display and sprite limits.

  3. 3

    Use /mythicmaps, /mmaps or /mmap.

  4. 4

    Test large animated displays before production use.

Source-verified reference

Checked against MythicMaps 1.0.0

This static reference is built from the supplied plugin.yml, YAML resources and Java source. No browser-generated documentation is used.

Main classme.Ghoul.MythicMaps.MainAPI version1.20Java classes21 Hard dependenciesNoneSoft dependenciesNoneLoad beforeNone

Commands

1 declared command

Aliases, usage and permissions come directly from plugin.yml.

/

/mythicmaps

Main MythicMaps command.

Aliases: /mmaps, /mmap · Usage: /mythicmaps · Permission: None declared

Permissions

2 declared permission nodes

Defaults and descriptions come directly from plugin.yml.

✓

mythicmaps.use

No description declared.

Default: True

✓

mythicmaps.admin

No description declared.

Default: op

Configuration reference

1 bundled YAML file

Top-level sections and defaults are summarised from the supplied resources.

⚙

config.yml

  • Settings — 6 nested settings: Prefix, Images-Folder, Default-Fit-Mode, Max-Wall-Width, Max-Wall-Height, Clean-Map-Names
  • GIF — 5 nested settings: Enabled, Speed-Multiplier, Frame-Skip, Pause-When-No-Players-Online, Minimum-Delay-Ticks
  • Displays — 2 nested settings: Default-Scale, Default-Billboard
  • Sprite-Engine — 5 nested settings: Default-Pixel-Scale, Default-Max-Width, Alpha-Threshold, Pixel-Step, Max-Entities

Source architecture

21 Java classes across 6 packages

managers (5), renderers (5), utils (5), models (4), commands (1), me.Ghoul.MythicMaps (1)

◆

Core systems

Main, FitMode, AnimatedMapRenderer, GifImageMapRenderer, OptimizedGifMapRenderer, StaticImageMapRenderer, StaticMapRenderer, GifFrame, GifUtil, ImageUtil, MessageUtil

◆

Commands

MythicMapsCommand

◆

Managers & services

AnimationManager, DataManager, DisplayManager, ImageMapManager, SpriteEngineManager

◆

Models & data

DisplayRecord, MapRecord, SpriteRecord

◆

Utilities

MapColorUtil

Tokens & placeholders

Text tokens found in the source

Availability depends on the feature that references each token.

%02X%

Related projects

Continue exploring