rPlace — Collaborative Pixel Canvas for Minecraft

Bring the iconic r/Place experience to your Minecraft server. Every player gets one block. Every pixel matters.

---

🎨 What is rPlace?

Inspired by Reddit's legendary r/Place experiment, this plugin lets your players collaboratively paint on a shared canvas using colored concrete blocks. With a cooldown system, rank support, and a live map overview, every placement becomes a strategic decision.

---

✨ Features

• Shared Canvas — Admins define a custom-sized canvas anywhere in the world using a simple selection wand (like WorldEdit)
• Right-Click Placement — Players don't actually build blocks; the plugin places them directly, allowing seamless overwriting of any pixel
• Cooldown System — Each player can place one block per minute (VIP rank: 30 seconds)
• Canvas Mode — Players enter a dedicated mode via /placeenter, get teleported to the center of the canvas, and receive their color palette
• Boundary Protection — Players cannot leave the canvas area while in canvas mode
• Flight Enabled — Players automatically receive flight when entering the canvas for a better overview
• Live Map Wall — Admins can spawn a wall of item frames displaying a live overview of the entire canvas, updating every 5 seconds
• White Base Layer — When a canvas is created, it is automatically filled with white concrete
• Block Protection — Canvas blocks cannot be broken or placed normally; only the plugin-controlled right-click system works
• Item Protection — Color palette items cannot be dropped, picked up, or moved out of the hotbar
• SQLite Persistence — All pixel data is saved to a local SQLite database and restored on server restart
• Permission System — Fine-grained control over who can paint, manage the canvas, and receive VIP cooldown reduction

---

🎮 Commands

| Command | Description |
|---|---|
| /placeenter | Enter canvas mode — teleports to canvas center, enables flight, gives color palette |
| /placeleave | Leave canvas mode — restores inventory and flight state |
| /rplace | (Admin) Receive the selection wand to define the canvas area |
| /placemap <width> <height> | (Admin) Spawn a live map wall on the surface you're looking at |

---

🔐 Permissions

| Permission | Default | Description |
|---|---|---|
| rplace.use | false | Allows entering the canvas and placing blocks |
| rplace.vip | false | Reduces cooldown from 60s to 30s |
| rplace.admin | op | Access to /rplace and /placemap |

---

🖼️ How the Map Wall Works

1. Build or find a flat wall
2. Look directly at the wall surface
3. Run /placemap <width> <height> (e.g. /placemap 4 4 for a 4×4 frame grid)
4. The plugin automatically spawns invisible, fixed item frames with maps that render the canvas in real time
5. The map updates every 5 seconds automatically

---

⚙️ Setup

1. Drop the JAR into your plugins/ folder
2. Start the server
3. Use /rplace to get the selection wand
4. Left-click a block for corner 1, right-click for corner 2
5. The canvas is instantly created and filled with white concrete
6. Assign rplace.use to the ranks that should be allowed to paint
7. (Optional) Set up a map wall with /placemap

---

📋 Requirements

• Server: Paper 1.21.1+
• Java: 21+
• No dependencies — SQLite is bundled

---

🔄 Data & Persistence

All canvas data is stored in a local SQLite database (plugins/rPlace/rplace.db). On every server restart, all pixels are automatically restored to the world exactly as they were left.

---

by maxmt