Chimage - Support URL+GIFs and Tools. | CursorCs

Chimage addon (FREE AT DISCORD)

is an official CursorCS addon designed to extend hologram capabilities with image, GIF, and video rendering pipelines.

Core features

  • Render images and GIFs directly on holograms using URLs or local assets.
  • Convert videos and images into optimized 2x2 tile-based PNG sequences (tile2x2).
  • Seamlessly integrates with existing CursorCS hologram systems.

Folder structure

Code: 
 plugins/chimage/
  ChimageBuild/
    vanilla/
  imagen/
  gif/
  video/
  compiled/
  images.yml

  • ChimageBuild/vanilla: bundled glyph/font resources
  • imagen: local image assets
  • gif: local GIF assets
  • video: source videos and processed output

Commands

  • /chimage set global <hologramId> <url> [size]
  • /chimage set player <player> <hologramId> <url> [size]
  • /chimage clear global <hologramId>
  • /chimage clear player <player> <hologramId>
  • /chimage list [player]
  • /chimage reload
  • /chimage video <file>
  • /chimage imagen <file>

Legacy:
- /chimage preprocess tile2x2 <videoFile> [tileSize] [frameStep] [fps]

Important:
  • hologramId must match a valid CursorCS hologram.
  • If the hologram does not exist, nothing will be rendered.

Image & GIF usage

URL example:

Code: 
/chimage set global blood https://i.ibb.co/5xzQrndR/imagen-2026-03-25-033559952.png 32

Local assets:

Code: 
images.yml:
global:
  blood:
    url: "asset://imagen/blood.png"
    size: 32
  spin_logo:
    url: "asset://gif/logo_spin.gif"
    size: 32

Then:

Code: 
/chimage reload

Video and image processing

Both /chimage video and /chimage imagen export content into 4 quadrants:
  • top_left
  • top_right
  • bottom_left
  • bottom_right

This enables efficient rendering of animated content through tiled holograms.

FFmpeg requirement

Video and image processing require FFmpeg.

Supported locations:
  • local binary (recommended in server root)
  • ffmpeg/bin/
  • system PATH fallback

Temporary processing files are automatically cleaned after execution.

Resourcepack integration

This system is intentionally split into two independent layers:

Vanilla glyph merge (required)
Provides rendering support for chimage glyphs.
Source:
Code: 
plugins/chimage/ChimageBuild/vanilla


CursorCS frame assets (optional)
Used for custom frame textures and animation pipelines.

Code: 
plugins/ItemsAdder/contents/cursorcs/
  configs/
  resourcepack/assets/cursorcs/textures/frames/
Top