{"id":122044,"date":"2026-06-07T07:16:07","date_gmt":"2026-06-07T04:16:07","guid":{"rendered":"https:\/\/vpesports.com\/minecraft\/mods\/pixelworks\/"},"modified":"2026-06-07T07:16:07","modified_gmt":"2026-06-07T04:16:07","slug":"pixelworks","status":"publish","type":"mod","link":"https:\/\/vpesports.com\/minecraft\/mods\/pixelworks\/","title":{"rendered":"PixelWorks"},"content":{"rendered":"

** PixelWorks Plugin – Complete Documentation<\/p>\n

\ud83c\udf86 Overview<\/p>\n

“`
\n _____ _ _ __ __ _
\n | __ (_) | | \/ \/ | |
\n | |__) |__ _____| | \/ \/ \/__ _ __| | _____
\n | ___\/ \/ \/ _ | \/ \/ \/ _ | ‘__| |\/ \/ __|
\n | | | |> < __\/ | \/ \/ (_) | | | <__ \n |_| |_\/_\/____|_| \/ \/ ___\/|_| |_|____\/\n```\n\n**Custom Particle Firework Shapes & Text for Minecraft**\n\n\n**PixelWorks** is a premium-quality Paper plugin that revolutionizes fireworks in Minecraft. Instead of standard firework explosions, PixelWorks displays stunning **custom shapes** and **readable text** made entirely of colored particles in the sky!\n\nPerfect for:\n- \ud83c\udf84 **Holiday Events** (Christmas, New Year, Halloween)\n- \ud83c\udf89 **Server Celebrations** (Anniversaries, Milestones)\n- \ud83c\udfc6 **Player Rewards** (Achievement unlocks, VIP perks)\n- \ud83c\udfa8 **Creative Builds** (Light shows, Decorations)\n- \ud83d\udce2 **Announcements** (Server messages in the sky)\n\n| Specification | Details |\n|--------------|---------|\n| **Plugin Name** | PixelWorks |\n| **Version** | 1.0.0 |\n| **API Version** | Paper 1.21+ |\n| **Compatibility** | Minecraft 1.21.1 - 1.21.4 |\n| **Java Version** | Java 21+ |\n| **Dependencies** | None (Standalone) |\n\n---\n\n\u2728 Key Features\n\n\ud83c\udfa8 Particle Rendering Engine\n\n| Feature | Description |\n|---------|-------------|\n| **Bitmap Font System** | Complete A-Z, 0-9, and punctuation rendered as 5\u00d77 pixel characters |\n| **ASCII Art Shapes** | Define custom shapes using simple grid patterns in config |\n| **Vector Mathematics** | Precise 2D to 3D transformation with rotation matrices |\n| **Player-Facing Display** | Patterns automatically rotate to face the launching player |\n| **Multi-line Text** | Automatic word wrapping for long messages |\n| **Dual Color Support** | Primary and secondary colors for detailed designs |\n| **Animated Display** | Particles persist for configurable duration |\n\n \ud83d\ude80 Custom Firework Items\n\n| Feature | Description |\n|---------|-------------|\n| **PDC Storage** | Pattern data stored using PersistentDataContainer (survives server restarts) |\n| **Custom Display Names** | Beautiful formatted names with icons |\n| **Detailed Lore** | Shows pattern type, content, and dimensions |\n| **Stack-friendly** | Items stack properly like vanilla fireworks |\n| **No NBT Issues** | Uses modern PDC system, not deprecated NBT tags |\n\n \ud83d\udee0\ufe0f Recipe System\n\n| Feature | Description |\n|---------|-------------|\n| **Shaped Recipes** | Define exact ingredient positions |\n| **Shapeless Recipes** | Any arrangement of ingredients works |\n| **Configurable Results** | Set how many fireworks each craft produces |\n| **Hot Reload** | Add new recipes without server restart |\n\n \ud83d\udce6 22 Pre-Built Patterns\n\n| Category | Patterns |\n|----------|----------|\n| **Mob Faces (12)** | Skeleton, Zombie, Villager, Pillager, Enderman, Warden, Wither, Dragon |\n| **Animals (6)** | Wolf, Cat, Axolotl, Panda, Reindeer |\n| **Players** | Steve |\n| **Objects (3)** | Christmas Tree, Gift Box, Cake |\n| **Text (4)** | Merry Christmas, Happy New Year, Happy New Year 2026, everETERNAL SMP |\n\n \u26a1 Performance Optimized\n\n| Feature | Description |\n|---------|-------------|\n| **Cached Calculations** | Pattern points calculated once then cached |\n| **Async Particle Spawning** | Non-blocking particle display |\n| **Configurable Limits** | Control particle count and spawn rate |\n| **View Distance** | Only spawn particles for nearby players |\n\n---\n\n \ud83d\udd27 How It Works\n\n The Process Flow\n\n```\n\u250c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510\n\u2502 Player crafts \u2502\n\u2502 or receives \u2502\n\u2502 PixelWorks \u2502\n\u2502 Firework \u2502\n\u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u252c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518\n \u2502\n \u25bc\n\u250c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510\n\u2502 Firework has \u2502\n\u2502 PDC data with \u2502\n\u2502 pattern_id \u2502\n\u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u252c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518\n \u2502\n \u25bc\n\u250c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510\n\u2502 Player launches\u2502\n\u2502 firework \u2502\n\u2502 (right-click) \u2502\n\u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u252c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518\n \u2502\n \u25bc\n\u250c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510\n\u2502 Firework flies \u2502\n\u2502 up and \u2502\n\u2502 explodes \u2502\n\u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u252c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518\n \u2502\n \u25bc\n\u250c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510\n\u2502 Plugin cancels \u2502\n\u2502 vanilla \u2502\n\u2502 explosion \u2502\n\u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u252c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518\n \u2502\n \u25bc\n\u250c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510\n\u2502 ParticleEngine \u2502\n\u2502 loads pattern \u2502\n\u2502 from config \u2502\n\u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u252c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518\n \u2502\n \u25bc\n\u250c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510\n\u2502 Calculate \u2502\n\u2502 rotation to \u2502\n\u2502 face player \u2502\n\u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u252c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518\n \u2502\n \u25bc\n\u250c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510\n\u2502 Transform 2D \u2502\n\u2502 points to 3D \u2502\n\u2502 world coords \u2502\n\u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u252c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518\n \u2502\n \u25bc\n\u250c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510\n\u2502 Spawn DUST \u2502\n\u2502 particles at \u2502\n\u2502 each point \u2502\n\u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u252c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518\n \u2502\n \u25bc\n\u250c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510\n\u2502 Beautiful \u2502\n\u2502 pattern \u2502\n\u2502 displayed! \u2502\n\u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518\n```\n\n Vector Mathematics Explained\n\nThe plugin uses **rotation matrices** to transform 2D grid coordinates into 3D world positions:\n\n```\nGiven:\n- Origin point (explosion location)\n- 2D grid point (x, y)\n- Yaw angle (direction to face)\n- Scale factor\n\nCalculate:\n1. Right vector = (cos(yaw), 0, sin(yaw))\n2. Up vector = (0, 1, 0)\n3. World position = Origin + (Right \u00d7 x \u00d7 scale) + (Up \u00d7 y \u00d7 scale)\n```\n\nThis ensures the pattern always faces the correct direction regardless of where the firework explodes.\n\n---\n\n \ud83d\udcbb Commands\n\n Main Command: `\/pw` (aliases: `\/pixelworks`, `\/fireworkart`)\n\n| Command | Description | Permission |\n|---------|-------------|------------|\n| `\/pw get [amount]` | Give yourself a custom firework | `pixelworks.get` |
\n| `\/pw create text ` | Create a new text pattern | `pixelworks.create` |
\n| `\/pw list [text|shape]` | List all available patterns | `pixelworks.command` |
\n| `\/pw info ` | View detailed pattern information | `pixelworks.command` |
\n| `\/pw test ` | Test-render a pattern above your head | `pixelworks.admin` |
\n| `\/pw reload` | Reload all configurations | `pixelworks.reload` |
\n| `\/pw help` | Show command help | `pixelworks.command` |<\/p>\n

Command Examples<\/p>\n

“`bash
\n Get 16 skeleton face fireworks
\n\/pw get skeleton_face 16<\/p>\n

Create a custom birthday message
\n\/pw create birthday text Happy Birthday!<\/p>\n

List only shape patterns
\n\/pw list shapes<\/p>\n

View info about the dragon pattern
\n\/pw info dragon<\/p>\n

Test the christmas tree pattern
\n\/pw test christmas_tree<\/p>\n

Reload after editing config
\n\/pw reload
\n“`<\/p>\n

—<\/p>\n

\ud83d\udd10 Permissions<\/p>\n

| Permission | Description | Default |
\n|————|————-|———|
\n| `pixelworks.command` | Access to base \/pw command | OP |
\n| `pixelworks.get` | Use \/pw get to obtain fireworks | OP |
\n| `pixelworks.create` | Create new patterns via command | OP |
\n| `pixelworks.reload` | Reload plugin configuration | OP |
\n| `pixelworks.use` | Craft and use custom fireworks | Everyone |
\n| `pixelworks.admin` | Full access to all features | OP |<\/p>\n

Permission Hierarchy<\/p>\n

“`
\npixelworks.admin
\n\u251c\u2500\u2500 pixelworks.command
\n\u251c\u2500\u2500 pixelworks.get
\n\u251c\u2500\u2500 pixelworks.create
\n\u251c\u2500\u2500 pixelworks.reload
\n\u2514\u2500\u2500 pixelworks.use
\n“`<\/p>\n

LuckPerms Examples<\/p>\n

“`bash
\n Give players access to use fireworks
\n\/lp group default permission set pixelworks.use true<\/p>\n

Give VIPs ability to get fireworks
\n\/lp group vip permission set pixelworks.get true<\/p>\n

Give admins full access
\n\/lp group admin permission set pixelworks.admin true
\n“`<\/p>\n

—<\/p>\n

\u2699\ufe0f Configuration<\/p>\n

Settings Section<\/p>\n

“`yaml
\nsettings:
\n Spacing between particles (smaller = denser, larger = spread out)
\n Recommended: 0.3 – 0.5
\n default-scale: 0.35<\/p>\n

Maximum distance players can see particles
\n Higher values may impact performance
\n view-distance: 64<\/p>\n

Should patterns rotate to face the launching player?
\n true = faces player, false = always faces south
\n face-player: true<\/p>\n

Size of each dust particle
\n 1.0 = normal, 0.5 = small, 2.0 = large
\n particle-size: 1.0<\/p>\n

How many particles spawn per game tick
\n Higher = faster display, more lag
\n particles-per-tick: 100<\/p>\n

How long the pattern stays visible (20 ticks = 1 second)
\n display-duration: 40<\/p>\n

Enable smooth color transitions
\n use-color-transition: false
\n“`<\/p>\n

Scale Visual Guide<\/p>\n

| Scale Value | Effect | Best For |
\n|————-|——–|———-|
\n| 0.2 | Very dense, compact | Small detailed shapes |
\n| 0.35 | Default, balanced | Most patterns |
\n| 0.5 | Spread out, large | Text, simple shapes |
\n| 0.75 | Very large | Giant displays |
\n| 1.0 | Maximum spread | Huge sky writing |<\/p>\n

Color Format Support<\/p>\n

| Format | Example | Description |
\n|——–|———|————-|
\n| Hex | `FF5500` | Standard hex color |
\n| Hex (no hash) | `FF5500` | Also works |
\n| RGB | `(255, 85, 0)` | RGB tuple |
\n| RGB (no parens) | `255, 85, 0` | Also works |
\n| Named | `red` | Predefined color names |
\n| Minecraft | `dark_purple` | MC color names |
\n| Custom | `christmas_red` | Plugin custom colors |<\/p>\n

Available Named Colors<\/p>\n

“`
\nStandard: Minecraft: Custom:
\n– white – dark_red – christmas_red
\n– silver – gold – christmas_green
\n– gray\/grey – dark_green – snow
\n– black – dark_aqua – gold_star
\n– red – dark_blue
\n– maroon – dark_purple
\n– yellow – light_purple
\n– olive – dark_gray
\n– lime
\n– green
\n– aqua
\n– teal
\n– blue
\n– navy
\n– fuchsia
\n– purple
\n– orange
\n“`<\/p>\n

—<\/p>\n

\ud83c\udfa8 Preset Patterns<\/p>\n

Text Patterns (4)<\/p>\n

| ID | Display Text | Colors |
\n|—-|————–|——–|
\n| `merry_christmas` | Merry Christmas | Red + Green |
\n| `happy_new_year` | Happy New Year | Gold + White |
\n| `happy_new_year_2026` | Happy New Year 2026 | Gold + Red |
\n| `evereternal_smp` | everETERNAL SMP | Purple + Blue |<\/p>\n

Shape Patterns (18)<\/p>\n

Mob Faces<\/p>\n

| ID | Description | Colors | Size |
\n|—-|————-|——–|——|
\n| `skeleton_face` | Skeleton skull | White + Black | 11\u00d711 |
\n| `zombie_face` | Zombie head | Green + Black | 11\u00d711 |
\n| `villager` | Villager face with nose | Tan + Green | 11\u00d711 |
\n| `pillager` | Pillager with angry eyes | Gray + Black | 11\u00d711 |
\n| `enderman` | Enderman with purple eyes | Black + Magenta | 11\u00d711 |
\n| `warden` | Deep dark Warden | Dark Cyan + Cyan | 13\u00d712 |
\n| `wither` | Three-headed Wither | Black + Gray | 19\u00d710 |
\n| `dragon` | Ender Dragon | Purple + Magenta | 17\u00d712 |<\/p>\n

Animals<\/p>\n

| ID | Description | Colors | Size |
\n|—-|————-|——–|——|
\n| `wolf` | Wolf\/Dog face | Silver + White | 11\u00d711 |
\n| `cat` | Orange tabby cat | Orange + Black | 11\u00d710 |
\n| `axolotl` | Pink axolotl | Pink + Hot Pink | 11\u00d710 |
\n| `panda` | Panda with eye patches | White + Black | 11\u00d710 |
\n| `reindeer` | Reindeer with antlers | Brown + Red | 11\u00d711 |<\/p>\n

Players & Objects<\/p>\n

| ID | Description | Colors | Size |
\n|—-|————-|——–|——|
\n| `steve` | Steve player head | Tan + Brown | 11\u00d711 |
\n| `christmas_tree` | Decorated tree | Green + Gold | 13\u00d715 |
\n| `gift_box` | Present with ribbon | Red + Gold | 11\u00d710 |
\n| `cake` | Birthday cake with candles | Cream + Red | 11\u00d79 |<\/p>\n

Visual Previews (ASCII)<\/p>\n

Skeleton Face
\n“`
\n XXXXXXX
\n XXXXXXXXX
\nXXXXXXXXXXX
\nXXX OOO XXX \u2190 Black eyes
\nXXX OOO XXX
\nXXXXXXXXXXX
\nXXXXXXXXXXX
\nXX XXXXX XX
\nXXX XXX \u2190 Mouth
\n XX X X XX
\n XXXXXXX
\n“`<\/p>\n

Christmas Tree
\n“`
\n O \u2190 Gold star
\n XXX
\n XXXXX
\n XXXXXXX
\n XXXXXXXXX
\n XXXXX
\n XXXXXXX
\n XXXXXXXXX
\n XXXXXXXXXXX
\n XXXXXXX
\n XXXXXXXXX
\n XXXXXXXXXXX
\nXXXXXXXXXXXXX
\n OOO \u2190 Trunk
\n OOO
\n“`<\/p>\n

Dragon
\n“`
\n X X \u2190 Wing tips
\nXX XXXXX XX
\n X XXXXXXX X
\n XXX O XXX \u2190 Eye
\n XXXXXXXXX
\n XXXXXXXXXXX
\n XXXXXXXXXXXXX
\n XX XXXXX XX
\n XXXXX
\n XX XX
\n XX XX
\n XXX XXX \u2190 Claws
\n“`<\/p>\n

—<\/p>\n

\ud83d\udd28 Custom Recipes<\/p>\n

Recipe Types<\/p>\n

| Type | Description |
\n|——|————-|
\n| **SHAPED** | Ingredients must be in specific positions |
\n| **SHAPELESS** | Any arrangement of ingredients works |<\/p>\n

Shaped Recipe Example<\/p>\n

“`yaml
\nrecipes:
\n skeleton_face:
\n type: SHAPED
\n pattern:
\n – ” S ” Row 1: Skull in middle
\n – “GPG” Row 2: Gunpowder, Paper, Gunpowder
\n – ” F ” Row 3: Firework Star in middle
\n ingredients:
\n S: SKELETON_SKULL
\n G: GUNPOWDER
\n P: PAPER
\n F: FIREWORK_STAR
\n result-amount: 3
\n“`<\/p>\n

**Crafting Grid Visualization:**
\n“`
\n\u250c\u2500\u2500\u2500\u252c\u2500\u2500\u2500\u252c\u2500\u2500\u2500\u2510
\n\u2502 \u2502 \ud83d\udc80\u2502 \u2502 \ud83d\udc80 = Skeleton Skull
\n\u251c\u2500\u2500\u2500\u253c\u2500\u2500\u2500\u253c\u2500\u2500\u2500\u2524
\n\u2502 \ud83d\udca5\u2502 \ud83d\udcc4\u2502 \ud83d\udca5\u2502 \ud83d\udca5 = Gunpowder, \ud83d\udcc4 = Paper
\n\u251c\u2500\u2500\u2500\u253c\u2500\u2500\u2500\u253c\u2500\u2500\u2500\u2524
\n\u2502 \u2502 \u2b50\u2502 \u2502 \u2b50 = Firework Star
\n\u2514\u2500\u2500\u2500\u2534\u2500\u2500\u2500\u2534\u2500\u2500\u2500\u2518
\n \u2193
\n 3\u00d7 Skeleton Fireworks
\n“`<\/p>\n

Shapeless Recipe Example<\/p>\n

“`yaml
\nrecipes:
\n merry_christmas:
\n type: SHAPELESS
\n ingredients:
\n – GUNPOWDER
\n – PAPER
\n – RED_DYE
\n – GREEN_DYE
\n result-amount: 3
\n“`<\/p>\n

All Default Recipes<\/p>\n

| Pattern | Recipe Type | Key Ingredients | Amount |
\n|———|————-|—————–|——–|
\n| `skeleton_face` | Shaped | Skeleton Skull, Gunpowder, Paper | 3 |
\n| `zombie_face` | Shaped | Zombie Head, Gunpowder, Paper | 3 |
\n| `santa_face` | Shaped | Red Wool, White Wool, Gunpowder | 3 |
\n| `christmas_tree` | Shaped | Oak Leaves, Oak Log, Gunpowder | 3 |
\n| `gift_box` | Shapeless | Red Wool, Gold Nugget, Gunpowder | 3 |
\n| `reindeer` | Shaped | Leather, Gunpowder, Paper | 3 |
\n| `dragon` | Shaped | Ender Eye, Dragon Breath, Gunpowder | 1 |
\n| `warden` | Shaped | Sculk, Echo Shard, Gunpowder | 1 |
\n| `wither` | Shaped | Wither Skull \u00d73, Nether Star | 1 |
\n| `villager` | Shaped | Emerald, Gunpowder, Paper | 3 |
\n| `pillager` | Shaped | Crossbow, Gunpowder, Paper | 3 |
\n| `wolf` | Shaped | Bone, Gunpowder, Paper | 3 |
\n| `axolotl` | Shaped | Tropical Fish, Gunpowder, Paper | 3 |
\n| `cat` | Shaped | Cod, String, Gunpowder, Paper | 3 |
\n| `enderman` | Shaped | Ender Pearl, Gunpowder, Paper | 3 |
\n| `panda` | Shaped | Bamboo, Gunpowder, Paper | 3 |
\n| `steve` | Shaped | Player Head, Gunpowder, Paper | 3 |
\n| `cake` | Shaped | Cake, Egg, Gunpowder, Paper | 3 |
\n| `merry_christmas` | Shapeless | Red Dye, Green Dye, Gunpowder, Paper | 3 |
\n| `happy_new_year` | Shapeless | Gold Nugget, Clock, Gunpowder, Paper | 3 |
\n| `happy_new_year_2026` | Shapeless | Gold Ingot, Clock, Gunpowder, Paper | 3 |<\/p>\n

—<\/p>\n

\ud83d\udd2c Technical Specifications<\/p>\n

System Requirements<\/p>\n

| Requirement | Minimum | Recommended |
\n|————-|———|————-|
\n| Java Version | 21 | 21+ |
\n| Server Software | Paper 1.21.1 | Paper 1.21.4 |
\n| RAM | 2GB | 4GB+ |
\n| CPU | 2 cores | 4+ cores |<\/p>\n

API Usage<\/p>\n

| Bukkit\/Paper API | Usage |
\n|——————|——-|
\n| `PersistentDataContainer` | Store pattern IDs on items |
\n| `NamespacedKey` | Unique identifiers for PDC and recipes |
\n| `Particle.DUST` | Colored particle display |
\n| `Particle.DustOptions` | RGB color configuration |
\n| `Adventure API` | Modern text components |
\n| `ShapedRecipe` \/ `ShapelessRecipe` | Custom crafting |
\n| `FireworkExplodeEvent` | Intercept explosions |<\/p>\n

Data Storage<\/p>\n

| Data Type | Storage Method |
\n|———–|—————-|
\n| Pattern definitions | `config.yml` (YAML) |
\n| Item pattern IDs | PDC on ItemStack |
\n| Recipe definitions | `config.yml` + Bukkit RecipeManager |<\/p>\n

Performance Metrics<\/p>\n

| Scenario | Particle Count | Performance Impact |
\n|———-|—————-|——————-|
\n| Simple text (10 chars) | ~350 particles | Minimal |
\n| Complex shape (15\u00d715) | ~150 particles | Minimal |
\n| Large text (50 chars) | ~1,750 particles | Low |
\n| Multiple simultaneous | Varies | Medium |<\/p>\n

Particle Calculations<\/p>\n

“`
\nText Pattern:
\n– Each character = 5\u00d77 grid = up to 35 particles
\n– Character spacing = 1 pixel
\n– Line spacing = 2 pixels
\n– “Hello” = 5 chars \u00d7 ~25 avg = ~125 particles<\/p>\n

Shape Pattern:
\n– Depends on grid size and density
\n– 11\u00d711 skeleton = ~80 particles
\n– 13\u00d715 tree = ~100 particles
\n“`<\/p>\n

—<\/p>\n

\ud83d\udce5 Installation Guide<\/p>\n

Step 1: Download
\nDownload `PixelWorks-1.0.0.jar` from the releases page.<\/p>\n

Step 2: Install
\n“`bash
\nNavigate to your plugins folder
\ncd \/path\/to\/server\/plugins\/<\/p>\n

Place the JAR file
\nmv ~\/Downloads\/PixelWorks-1.0.0.jar .\/
\n“`<\/p>\n

Step 3: Start Server
\n“`bash
\n Start or restart your server
\n.\/start.sh
\n or
\njava -jar paper-1.21.4.jar
\n“`<\/p>\n

Step 4: Verify
\n“`bash
\nCheck console for success message
\n[PixelWorks] PixelWorks has been enabled!
\n[PixelWorks] Loaded 22 patterns.<\/p>\n

In-game verification
\n\/pw list
\n“`<\/p>\n

Step 5: Configure (Optional)
\n“`bash
\n Edit configuration
\nnano plugins\/PixelWorks\/config.yml<\/p>\n

Reload in-game
\n\/pw reload
\n“`<\/p>\n

File Structure After Installation<\/p>\n

“`
\nplugins\/
\n\u2514\u2500\u2500 PixelWorks\/
\n \u2514\u2500\u2500 config.yml # Main configuration file
\n“`<\/p>\n

—<\/p>\n

\ud83c\udfa8 Creating Custom Patterns<\/p>\n

Creating a Text Pattern<\/p>\n

**Method 1: Command (Quick)**
\n“`bash
\n\/pw create my_birthday text Happy Birthday!
\n“`<\/p>\n

**Method 2: Config (Full Control)**
\n“`yaml
\ntexts:
\n my_birthday:
\n display: “Happy Birthday!”
\n color: “#FF69B4”
\n secondary-color: “#FFD700”
\n scale: 0.35
\n max-line-width: 20
\n centered: true
\n“`<\/p>\n

Creating a Shape Pattern<\/p>\n

**Step 1: Design your ASCII art**
\n“`
\nPlan on paper or text editor:<\/p>\n

XXX (3 wide)
\n XXXXX (5 wide)
\n XXXXXXX (7 wide)
\nXXXXXXXXX (9 wide – max width)
\n XXX (trunk)
\n“`<\/p>\n

**Step 2: Add to config**
\n“`yaml
\nshapes:
\n my_tree:
\n color: “#228B22”
\n secondary-color: “#8B4513”
\n scale: 0.4
\n primary-char: “X”
\n secondary-char: “O”
\n centered: true
\n grid:
\n – ” XXX ”
\n – ” XXXXX ”
\n – ” XXXXXXX ”
\n – “XXXXXXXXX”
\n – ” OOO ”
\n“`<\/p>\n

**Step 3: Add a recipe (optional)**
\n“`yaml
\nrecipes:
\n my_tree:
\n type: SHAPELESS
\n ingredients:
\n – GUNPOWDER
\n – PAPER
\n – OAK_SAPLING
\n result-amount: 3
\n“`<\/p>\n

**Step 4: Reload and test**
\n“`bash
\n\/pw reload
\n\/pw test my_tree
\n\/pw get my_tree
\n“`<\/p>\n

Shape Design Tips<\/p>\n

| Tip | Explanation |
\n|—–|————-|
\n| **Start simple** | Begin with 7\u00d77 or smaller grids |
\n| **Use spaces** | Spaces are transparent (no particle) |
\n| **Symmetry helps** | Centered shapes look better |
\n| **Test often** | Use `\/pw test` to preview |
\n| **Two colors** | Use O for details (eyes, patterns) |
\n| **Consistent width** | Pad lines with spaces for alignment |<\/p>\n

Multi-line Text<\/p>\n

“`yaml
\ntexts:
\n server_rules:
\n display: “Welcome to\\nMy Server\\nHave Fun!”
\n Results in:
\n Welcome to
\n My Server
\n Have Fun!
\n“`<\/p>\n

—<\/p>\n

\u2753 FAQ<\/p>\n

General Questions<\/p>\n

**Q: Does this work with Spigot?**
\n> A: PixelWorks is designed for Paper 1.21+. It may work on Spigot but is untested and unsupported.<\/p>\n

**Q: Can players grief with fireworks?**
\n> A: PixelWorks fireworks are purely visual (particles only). They don’t cause damage or place blocks.<\/p>\n

**Q: Do patterns persist after server restart?**
\n> A: Yes! Pattern data is stored using PersistentDataContainer which persists across restarts.<\/p>\n

**Q: Can I use custom colors?**
\n> A: Yes! Use hex codes (#FF5500), RGB (255, 85, 0), or named colors.<\/p>\n

Technical Questions<\/p>\n

**Q: Why don’t I see the pattern?**
\n> Check:
\n> – Pattern ID is correct (`\/pw list`)
\n> – View distance settings
\n> – Particle settings in video options
\n> – You have permission to use the firework<\/p>\n

**Q: How do I make patterns bigger?**
\n> Increase the `scale` value in config (e.g., 0.5 instead of 0.35)<\/p>\n

**Q: Can I disable vanilla firework explosions for all fireworks?**
\n> A: No, PixelWorks only affects its own custom fireworks. Vanilla fireworks work normally.<\/p>\n

**Q: Performance with many fireworks?**
\n> A: Each firework spawns 50-200 particles. With `display-duration: 40`, that’s 2 seconds of particles. For large events, consider lower duration or fewer simultaneous fireworks.<\/p>\n

Customization Questions<\/p>\n

**Q: Can I add my own shapes?**
\n> A: Yes! Add them to the `shapes:` section in config.yml. See “Creating Custom Patterns” above.<\/p>\n

**Q: What characters are supported for text?**
\n> A: A-Z, 0-9, and: `.` `,` `!` `?` `-` `:` `’` `#` `@` `*` `\/` `&` (space)<\/p>\n

**Q: Can I use lowercase letters?**
\n> A: Letters are converted to uppercase for display. Lowercase in config works fine.<\/p>\n

**Q: Maximum text length?**
\n> A: No hard limit, but long text will wrap to multiple lines. Keep under 50 characters for best results.<\/p>\n

—<\/p>\n

\ud83d\udcdd Changelog<\/p>\n

Version 1.0.0 (Initial Release)<\/p>\n

Features
\n– \u2705 Particle rendering engine with vector mathematics
\n– \u2705 Complete bitmap font (A-Z, 0-9, punctuation)
\n– \u2705 18 pre-built shape patterns
\n– \u2705 4 pre-built text patterns
\n– \u2705 Custom shaped and shapeless recipes
\n– \u2705 PersistentDataContainer item storage
\n– \u2705 Full command system with tab completion
\n– \u2705 Adventure API text components
\n– \u2705 Player-facing rotation
\n– \u2705 Multi-line text support
\n– \u2705 Dual color system (primary + secondary)
\n– \u2705 Configurable display duration
\n– \u2705 Hot reload support<\/p>\n

Included Patterns
\n**Shapes:** Skeleton, Zombie, Santa, Christmas Tree, Gift Box, Reindeer, Dragon, Warden, Wither, Villager, Pillager, Wolf, Axolotl, Cat, Enderman, Panda, Steve, Cake<\/p>\n

**Texts:** Merry Christmas, Happy New Year, Happy New Year 2026, <\/p>\n

—<\/p>\n

“`<\/p>\n

—<\/p>\n

**Made with \u2764\ufe0f for Minecraft servers everywhere**
\n**<\/p>\n","protected":false},"excerpt":{"rendered":"

A plugin extension for new custom text and doodle fireworks (christmas nd new year special)<\/p>\n","protected":false},"featured_media":122045,"template":"","meta":{"_minecraft_slug":"pixelworks","_minecraft_project_id":"7VzUAFUB","_minecraft_author":"geturplugins","_minecraft_license":"LicenseRef-All-Rights-Reserved","_minecraft_downloads":52,"_minecraft_follows":0,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"pixelworks.zip","_minecraft_size_bytes":61994,"_minecraft_version_count":1,"_minecraft_updated_at":"2026-05-15T21:02:18.398519Z","_minecraft_date_created":"2025-12-17T23:56:49.653964Z","_minecraft_date_modified":"2025-12-14T15:15:20.702095Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/pixelworks","_minecraft_icon_attachment_id":122045,"_minecraft_imported_at":"2026-06-07T04:16:08+00:00","_minecraft_import_hash":"3ca482297db92e3a6dd96719d9daea81","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[156,127,92],"mod_loader":[132],"minecraft_version":[37,73,74,38,78,79,80,81],"class_list":["post-122044","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-decoration","mod_category-paper","mod_category-utility","mod_loader-paper","minecraft_version-1-21-1","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8"],"yoast_head":"\nPixelWorks - Minecraft<\/title>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/vpesports.com\/minecraft\/mods\/pixelworks\/\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"PixelWorks - Minecraft\" \/>\n<meta property=\"og:description\" content=\"A plugin extension for new custom text and doodle fireworks (christmas nd new year special)\" \/>\n<meta property=\"og:url\" content=\"https:\/\/vpesports.com\/minecraft\/mods\/pixelworks\/\" \/>\n<meta property=\"og:site_name\" content=\"Minecraft\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:label1\" content=\"Est. reading time\" \/>\n\t<meta name=\"twitter:data1\" content=\"2 minutes\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\\\/\\\/schema.org\",\"@graph\":[{\"@type\":\"WebPage\",\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/pixelworks\\\/\",\"url\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/pixelworks\\\/\",\"name\":\"PixelWorks - Minecraft\",\"isPartOf\":{\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/#website\"},\"primaryImageOfPage\":{\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/pixelworks\\\/#primaryimage\"},\"image\":{\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/pixelworks\\\/#primaryimage\"},\"thumbnailUrl\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/wp-content\\\/uploads\\\/2026\\\/06\\\/pixelworks-icon-a6f312d18e216c3698291a1139fa833c1d080515_96.webp\",\"datePublished\":\"2026-06-07T04:16:07+00:00\",\"breadcrumb\":{\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/pixelworks\\\/#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/pixelworks\\\/\"]}]},{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/pixelworks\\\/#primaryimage\",\"url\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/wp-content\\\/uploads\\\/2026\\\/06\\\/pixelworks-icon-a6f312d18e216c3698291a1139fa833c1d080515_96.webp\",\"contentUrl\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/wp-content\\\/uploads\\\/2026\\\/06\\\/pixelworks-icon-a6f312d18e216c3698291a1139fa833c1d080515_96.webp\",\"width\":96,\"height\":96},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/pixelworks\\\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Home\",\"item\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Mods\",\"item\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"PixelWorks\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/#website\",\"url\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/\",\"name\":\"Minecraft\",\"description\":\"\",\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/?s={search_term_string}\"},\"query-input\":{\"@type\":\"PropertyValueSpecification\",\"valueRequired\":true,\"valueName\":\"search_term_string\"}}],\"inLanguage\":\"en-US\"}]}<\/script>\n<!-- \/ Yoast SEO plugin. -->","yoast_head_json":{"title":"PixelWorks - Minecraft","robots":{"index":"index","follow":"follow","max-snippet":"max-snippet:-1","max-image-preview":"max-image-preview:large","max-video-preview":"max-video-preview:-1"},"canonical":"https:\/\/vpesports.com\/minecraft\/mods\/pixelworks\/","og_locale":"en_US","og_type":"article","og_title":"PixelWorks - Minecraft","og_description":"A plugin extension for new custom text and doodle fireworks (christmas nd new year special)","og_url":"https:\/\/vpesports.com\/minecraft\/mods\/pixelworks\/","og_site_name":"Minecraft","twitter_card":"summary_large_image","twitter_misc":{"Est. reading time":"2 minutes"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"WebPage","@id":"https:\/\/vpesports.com\/minecraft\/mods\/pixelworks\/","url":"https:\/\/vpesports.com\/minecraft\/mods\/pixelworks\/","name":"PixelWorks - Minecraft","isPartOf":{"@id":"https:\/\/vpesports.com\/minecraft\/#website"},"primaryImageOfPage":{"@id":"https:\/\/vpesports.com\/minecraft\/mods\/pixelworks\/#primaryimage"},"image":{"@id":"https:\/\/vpesports.com\/minecraft\/mods\/pixelworks\/#primaryimage"},"thumbnailUrl":"https:\/\/vpesports.com\/minecraft\/wp-content\/uploads\/2026\/06\/pixelworks-icon-a6f312d18e216c3698291a1139fa833c1d080515_96.webp","datePublished":"2026-06-07T04:16:07+00:00","breadcrumb":{"@id":"https:\/\/vpesports.com\/minecraft\/mods\/pixelworks\/#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/vpesports.com\/minecraft\/mods\/pixelworks\/"]}]},{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/vpesports.com\/minecraft\/mods\/pixelworks\/#primaryimage","url":"https:\/\/vpesports.com\/minecraft\/wp-content\/uploads\/2026\/06\/pixelworks-icon-a6f312d18e216c3698291a1139fa833c1d080515_96.webp","contentUrl":"https:\/\/vpesports.com\/minecraft\/wp-content\/uploads\/2026\/06\/pixelworks-icon-a6f312d18e216c3698291a1139fa833c1d080515_96.webp","width":96,"height":96},{"@type":"BreadcrumbList","@id":"https:\/\/vpesports.com\/minecraft\/mods\/pixelworks\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https:\/\/vpesports.com\/minecraft\/"},{"@type":"ListItem","position":2,"name":"Mods","item":"https:\/\/vpesports.com\/minecraft\/mods\/"},{"@type":"ListItem","position":3,"name":"PixelWorks"}]},{"@type":"WebSite","@id":"https:\/\/vpesports.com\/minecraft\/#website","url":"https:\/\/vpesports.com\/minecraft\/","name":"Minecraft","description":"","potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/vpesports.com\/minecraft\/?s={search_term_string}"},"query-input":{"@type":"PropertyValueSpecification","valueRequired":true,"valueName":"search_term_string"}}],"inLanguage":"en-US"}]}},"_links":{"self":[{"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/mod\/122044","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/mod"}],"about":[{"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/types\/mod"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/media\/122045"}],"wp:attachment":[{"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/media?parent=122044"}],"wp:term":[{"taxonomy":"mod_category","embeddable":true,"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/mod_category?post=122044"},{"taxonomy":"mod_loader","embeddable":true,"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/mod_loader?post=122044"},{"taxonomy":"minecraft_version","embeddable":true,"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/minecraft_version?post=122044"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}