images folder - magemonkeystudio/fabled GitHub Wiki

๐Ÿ–ผ images โ€” Particle Image Assets

The images folder is used by Fabled to store .png files that are displayed in-game using the Particle Image mechanic.

This allows skills to project custom images using Minecraft particles, creating highly visual effects such as floating glyphs, class emblems, or spell circles.

๐Ÿ“‚ Folder Location

/plugins/Fabled/images/

๐ŸŽฏ What Is It Used For?

Images in this folder are used by the Particle Image mechanic โ€” a skill component that renders a .png image with particles when triggered.

This can be used to:

  • Display a static or following image effect
  • Show magic runes, icons, or emblems
  • Add cinematic or immersive feedback to skill casting

๐Ÿ“ How to Add an Image

  1. Save your image as a .png file
  2. Place it inside: 
    /plugins/Fabled/images/
  3. In the Web Editor, add a Particle Image mechanic to your skill
  4. Select the image by filename (without .png)

๐Ÿ“Œ Subfolders are not supported โ€” files must be directly in the images directory.

๐Ÿงฑ Recommended Specs

  • Format: .png
  • Dimensions: 32x32 or 64x64 for best performance and readability
  • Use bold designs and high contrast colors for visibility

โš™๏ธ Particle Image Mechanic Settings

These are the configurable fields for the Particle Image mechanic in the Web Editor:

Setting Description
Image Name of the .png image in the images folder (exclude extension)
Particle The Minecraft particle type to use (e.g. flame, redstone)
Scale How large to render the image (e.g. 1.0 = original size)
Follow Target If enabled, makes the image follow the skill's target
Visibility Radius Maximum distance (in blocks) other players can see the image
Rotate Whether the image should rotate with the target or face the viewer

๐Ÿงช Example Use Cases

  • ๐Ÿ”ฅ Fire skill projecting a flame rune over the target
  • ๐Ÿง™โ€โ™‚๏ธ Summon animation showing a glowing emblem
  • ๐ŸŒ€ Debuff skill that floats a warning icon above an enemy
  • โœจ Class-specific skill that uses a faction logo

โœ… Tips

  • Preview in-game after upload to fine-tune scale and placement
  • Use minimal or bold artwork โ€” small details may not show clearly
  • Combine with other mechanics (particles, sounds, messages) for full effect

๐Ÿ”— Related Pages