⚡ Why Custom Images+?

The original Custom Images plugin is great, but it hasn't kept up with modern needs. Discord changed their CDN in 2024 and now serves images as WebP — breaking every image plugin that tries to load Discord URLs. On top of that, the original has no multilanguage support, no region protection, no per-rank limits, and no reload command.

Custom Images+ fixes all of that.

✦━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━✦

The Killer Feature: Discord URL Support

Your players already use Discord. Now they can use it as their image host:

1. Upload any image to any Discord channel or chat
2. Right-click the image → "Copy image link"
3. Paste the URL in /images create <URL>
4. Click on a wall → done. The image is placed.

No extra steps. No external hosting. No format errors.

The plugin automatically detects Discord URLs, converts media.discordapp.net to cdn.discordapp.com, strips the WebP conversion parameters, and keeps the authentication tokens. Your players don't need to know any of this — they just paste and it works.

Also supports direct URLs from Imgur, websites, or any link ending in .png / .jpg

Local files too!
You can also place image files (.png, .jpg) directly in the plugins/Images/ folder. Then in-game, type /images create and press TAB — the plugin auto-suggests all available images from the folder. No URL needed.



✦━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━✦

v1.4 — Visual management GUI (/image gui)

Chest-based management menu, one command away

Tired of walking to every image to click-delete? Tired of grepping images.log to figure out who placed what? Run /image gui (alias /imagen menu) and get a unified visual inventory for admins AND users:

• "Your Images" — everyone lands on their own personal scope first: stats, a browser filtered to images they placed, and a one-click delete for each of their own entries
• Create + Delete buttons for users — regular players never have to learn chat commands. The top row shows a green Create image button (prompts for a URL + scale in chat, then click a wall) and a red Delete image button (puts you in right-click-to-delete mode, sneak to cancel). Works identically on Java, Bedrock PC, and Bedrock mobile
• Admin shortcuts — holders of images.gui.admin get an extra bottom row with Browse-all, Filter (world/date/status), Hidden, Banned, Orphan scan, Leaderboard, Export CSV. Regular players see decorative crystals instead
• Smart titles — "Your Images" / "My Images" for personal scope, "Manage" for admin server-wide, so staff always know what they're acting on

Brand-new moderation primitives

• Hide / Unhide — un-render an image for everyone without destroying its data. Reversible. Useful when you want to temporarily take down content without losing the placement
• Ban / Unban — hard moderation flag with admin + reason + timestamp. Only staff with images.gui.ban can lift. Survives restarts
• Move (true relocate) — keep the same database id, creator, placedAt and history. Click Move → confirm → right-click the new block. No orphan audit trail from delete+recreate
• Bulk actions — toggle multi-select, pick N images, then Bulk Delete / Ban / Hide with one confirmation
• Context-aware buttons — ban/hide/move never appear on your own images. Admins see the full toolbox only on others' content

Discovery & housekeeping

• Image finder — type a keyword in chat to filter by name or URL. Admin search covers the server; users search their own
• Orphan scan — finds images whose item-frames were destroyed but metadata is still in the DB. Bulk-delete the leftovers with one click
• Owner leaderboard — top players by image count and storage used
• CSV export — dumps the full registry to plugins/ImagesPlus/exports/images-<timestamp>.csv (17 columns)

️ Personalization & audit

• Image alias — set a personal label on your own images ("Living Room", "Shop Banner") so the GUI is readable. The original filename stays untouched in the lore
• Safe teleport — the TP button stands you 2–3 blocks in front, looking at the image, on safe ground. No falling into lava
• Confirmation dialog on every destructive action — short title, full prompt wrapped on a paper item inside the menu
• New audit tags in images.log: HIDE, UNHIDE, BAN, UNBAN, MOVE, BULK_DELETE, GUI_TP. GUI-driven removals add via=GUI / via=BULK. A "History" button in the detail menu surfaces the last 5 log entries for that image

Fully translatable
Every GUI string (titles, buttons, lores, click hints, messages, stats) is a lang key. Drop a pt.yml / fr.yml in plugins/ImagesPlus/lang/ and reload. Unified color palette across all buttons: green = positive, red = destructive, gold = highlight, aqua = tool, yellow = navigation.

Plugin rename
The plugin now shows as ImagesPlus in /pl and logs — no more confusion with the original Custom Images. On first boot the data folder plugins/Images/ is automatically migrated to plugins/ImagesPlus/. No manual step, no data loss. All existing images, config and lang files come along.

✦━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━✦

v1.2 — Audit log & click-to-inspect

Detailed audit log (plugins/Images/images.log)

Every image placement and removal is written to a plain-text, grep-friendly log file. Perfect for anti-grief investigations and activity audits.

• Toggle via logging.enabled: true in config
• Thread-safe, append-only — survives restarts
• Use tail -f to watch live, grep "player=Xxx" to audit a specific user
• Covers both placements and removals, with confidence level (EXACT vs PROBABLE for area deletes)

Click-to-inspect (/imagen quien / /images who)

Run the command, then click any image in the world to see a detailed info panel:

• DB-backed storage — every v1.2+ image stores its own metadata (placedAt, source, URL, scale) in the plugin database
• Instant lookup — no log parsing needed for new images
• Log fallback — older images without DB metadata are resolved by parsing images.log
• Perfect for staff — answer "who put that up?" in one click

Other v1.2 fixes

• Lang auto-merge — new message keys in future updates are merged into your existing lang/*.yml files automatically, so you never get <placeholder.key> on screen after an update
• "Just works" defaults — the config now ships with place-mode: OP and safe default permissions, so the plugin works immediately after drop-in without LP setup
• Separated images.command.placed permission — was sharing images.command.list in v1.1, now cleanly separated (staff can have audit tools without granting list)

✦━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━✦

Multilanguage — Not Just Bilingual

The plugin ships with English and Spanish fully translated (47 configurable message keys each). But you can add any language:

1. Copy lang/en.yml to lang/pt.yml (or any language code)
2. Translate the values
3. Run /images reload — loaded instantly, no restart needed

Smart language detection: The plugin detects the language from the command the player uses:

• /imagen crear → Spanish messages and tab suggestions
• /images create → English messages and tab suggestions
• Mix freely: /images crear works (English messages), /imagen create works (Spanish messages)

✦━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━✦

Commands

Spanish
English
Root aliases: /image, /images, /img, /customimage, /imagen, /imagenes

Each subcommand also has aliases: crear/new/add/load, eliminar/del/remove/borrar/quitar, lista/options/opciones, recargar/rl, etc.

✦━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━✦

Scale

Control the image size with any number after the URL:

• 10-20 — Fits in 1 block (icons, small logos, details)
• 50 — Half size
• 100 — Original size (default if omitted)
• 150 — 50% larger
• 200 — Double size

Use any number you want: 25, 70, 80, 120... experiment until it looks right. Don't like it? Delete and recreate with a different scale.

Each Minecraft block = 128x128 pixels. A 1280x720 image at scale 100 occupies ~10x6 blocks.

✦━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━✦

️ Supported Image Formats

• PNG — Recommended. Supports full transparency (transparent areas are invisible on Java Edition)
• JPG/JPEG — Great for photos, no transparency
• BMP — Uncompressed, large files
• GIF — First frame only (not animated)
• Discord URLs — Auto-converted from WebP. Just paste the link

Transparency: PNG images with transparent backgrounds are supported. Transparent areas show as the default map color (light beige). Combine with invisible-frames: true (default on 1.16+) for best results.

Placement: Images must be placed on a solid block (wall, floor, or ceiling). Horizontal placement (floor/ceiling) supported on 1.13+.

Protocols: http://, https://, ftp://, ftps://

Security: The plugin automatically rejects local, loopback, and internal network URLs to prevent SSRF attacks.

✦━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━✦



✦━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━✦

Permissions

Why the true defaults? So the plugin just works after drop-in. Anyone can run the commands, but actual placement is gated by place-mode in config.yml (default OP — only the server owner actually places on a fresh install). Non-ops get a clean "can't place here" message instead of "unknown command", so they don't think the plugin is broken.

Want to restrict further? Override with LuckPerms:
Staff groups (audit tools + destructive commands):
✦━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━✦

Permission Modes (place-mode)

Control who can create images beyond basic permissions:

• ALL — Anyone with the create permission
• OP — Server operators only
• PERMISSION — Only players with images.place
• GROUP — Only players in allowed-groups (requires Vault + a permissions plugin like LuckPerms)

✦━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━✦

Per-Group Image Limits

Set different limits for each rank. The player gets the highest limit from all their groups. OP is always unlimited.

Uses group.<name> permissions from LuckPerms for automatic group detection.

✦━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━✦

️ WorldGuard & ProtectionStones Integration

Control where players can place images:

• No region (wilderness) → ✅ Allowed
• Own ProtectionStones protection → ✅ Allowed
• Member of someone's region → ✅ Allowed
• Someone else's region, not a member → ❌ Blocked
• Staff groups (in region-bypass-groups) → ✅ Always allowed
• OP or images.region.bypass → ✅ Always allowed

The __global__ WorldGuard region is automatically ignored. If WorldGuard isn't installed or encounters an error, the plugin fails-open (allows the action). Uses reflection — no compile-time dependency on WorldGuard.

✦━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━✦

Creator Protection

When true, only the player who created an image can delete it. Other players cannot delete images they didn't create, even if they have the delete permission. Players with images.restricted.bypass can delete any image (useful for staff cleaning up inappropriate content).

✦━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━✦

Installation

1. Drop the JAR in your plugins/ folder
2. Start the server. Done.

The plugin auto-generates everything on first run:

• config.yml — Full configuration with comments
• lang/en.yml — English (200+ translatable keys including full GUI)
• lang/es.yml — Spanish (200+ translatable keys including full GUI)
• images.db — SQLite database
• WIKI.md — Complete 1000+ line documentation

Data folder: the plugin installs itself to plugins/ImagesPlus/. If you were on v1.3 or earlier (which used plugins/Images/) the folder is renamed automatically on first boot — zero manual steps, zero data loss.

Built-in Documentation
This plugin includes a complete 780-line WIKI inside the JAR. On first run, it automatically extracts to plugins/Images/WIKI.md. No need to visit this page again — everything is in your server. Open it with any text editor, or feed it to an AI assistant to configure the plugin for you in seconds.

⬆️ Coming from the original Custom Images?
Just replace the old JAR with this one. That's it. Your existing images, database, and config are fully compatible — nothing breaks, nothing is lost. The plugin reads the same SQLite/MySQL database and the same image files. On first load it will auto-add the new config keys without touching your existing settings. All your placed images will appear exactly as before, plus you now have all the new features.

Upgrading between versions of Custom Images+? Same thing — replace the JAR. New config keys are auto-added without losing your existing settings.

Optional dependencies:

• Vault + permissions plugin — Required for place-mode: GROUP
• WorldGuard — Required for region-restricted: true
• ProtocolLib — Improves stability on versions below 1.21. On 1.21+ the plugin deliberately disables ProtocolLib and uses its own packet implementation for better reliability

Database options: SQLite (default), MySQL, or flat file. Transfer between them with /images transfer.

✦━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━✦

⚙️ Full Configuration


✦━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━✦

Troubleshooting


✦━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━✦

What's New vs Original Custom Images

• Discord URLs — Original: ❌ broken. This fork: ✅ auto-converts
• Language — Original: English only, hardcoded. Fork: Multilang with editable YAML files
• Commands — Original: English only. Fork: Bilingual ES/EN with smart detection
• Tab completion — Original: English only. Fork: Adapts to command language
• Permission modes — Original: basic nodes only. Fork: ALL/OP/PERMISSION/GROUP via Vault
• Image limits — Original: none. Fork: Per-group configurable limits
• Region protection — Original: none. Fork: WorldGuard + ProtectionStones
• Staff bypass — Original: none. Fork: Configurable bypass groups
• Creator protection — Original: basic. Fork: Documented + bypass permission
• Reload command — Original: doesn't exist. Fork: /images reload
• Config upgrade — Original: none. Fork: Auto-adds new keys on update
• List placed images — Original: none. Fork: /images placed [radius] shows world, coords, creator. Click to TP
• Click-to-inspect (v1.2) — Original: none. Fork: /images who — click any image to see who placed it, when, from where, scale, source URL
• Audit log (v1.2) — Original: none. Fork: every PLACE/REMOVE written to plugins/Images/images.log with full context
• DB metadata (v1.2) — Original: only creator UUID. Fork: also placedAt, source, URL, scale stored per image
• Management GUI (v1.4) — Original: none. Fork: /image gui chest menu for admins AND users, with browse / filter / search / teleport / move / hide / ban / delete / bulk / leaderboard / orphan-scan / CSV export, all fully translated and customizable via lang files
• Quick disconnect crash — Original: NoSuchElementException when player leaves quickly. Fork: Fixed
• Local files + TAB — Place .png/.jpg in plugin folder, TAB auto-suggests file names
• Documentation — Original: SpigotMC page. Fork: 990+ line WIKI auto-extracted to plugin folder

✦━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━✦

Credits

• Original plugin: Andavin — Custom Images v2.5.9
• Fork & improvements: VenecoLuis — Mundo Veneco
• AI-assisted development: Claude Code by Anthropic (Opus 4.6)
• License: MIT

This entire fork was developed with AI assistance in approximately 1 hour — from source analysis to multilanguage system, WorldGuard integration, Discord URL support, per-group limits, full documentation (780-line WIKI), and production deployment with 130+ active images. All coded, tested, and shipped using Claude Code by Anthropic, demonstrating that with the right AI tools you can significantly improve existing plugins in under an hour, not weeks.

✦━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━✦