ChaosCraft's Device's

<div style="text-align: center;"><a style="display: inline-block;" href="https://ko-fi.com/blackrift_studios" target="_blank" rel="nofollow noopener"><img style="display: block;" src="https://i.imgur.com/138LVzD.png" alt="Support on Ko-fi" width="250"></a></div>

<h2 style="color: #2ecc71; text-align: center;">🖥️ CHAOSCRAFT'S DEVICE'S 🖥️</h2>

A lightweight in-game desktop for Minecraft featuring windowed apps, virtual files, wallpapers, and per-player persistence. Bring a tiny PC into Minecraft!

<div style="background-color: rgba(76, 175, 80, 0.1); border: 2px solid #4CAF50;"><h3 style="color: #388e3c;">🔧<strong>Required Dependecies </strong></h3><ul><li>GeckoLib v.4.7.4+</li></ul></div>

<div style="background-color: rgba(46, 204, 113, 0.1); border: 2px solid #2ecc71;"><h3 style="color: #27ae60;">🚀 Instant In-Game Desktop</h3><p>Transform your Minecraft experience with a true desktop environment - drag windows, manage files, customize wallpapers, and run built-in or custom apps, all inside Minecraft - just drop the jar in your mods folder!</p></div>

<div style="background-color: rgba(241, 196, 15, 0.1); border: 2px solid #f1c40f;"><h3 style="color: #f39c12;">🌟 Persistent & Extensible</h3><p>App and desktop state are saved per-player (JSON + world FS). Modpack authors: easily customize, extend, and persist app state and files. Register custom apps/icons at runtime with simple APIs.</p></div>

<div style="background-color: rgba(155, 89, 182, 0.1); border: 2px solid #9b59b6;"><h3 style="color: #9b59b6;">🖼️ Wallpaper & Media Support</h3><p>Supports solid colors, PNG/JPG/GIF wallpapers, and animated backgrounds. Paint app exports PNGs. Add new wallpapers by dropping images in the runtime folder - no resource pack needed.</p></div>

<div style="background-color: rgba(231, 76, 60, 0.1); border: 2px solid #e74c3c;"><h3 style="color: #c0392b;">⚠️ Compatibility Notice</h3><p>Supported on <strong>Minecraft 1.20.1</strong> with <strong>Forge 47.4.0</strong>.</p></div>

<h4 style="color: #27ae60;">⚡ Key Features</h4>

* Full desktop UI: draggable windows, icons, taskbar, previews
* Built-in apps: Files, Notes, Notepad, Paint, Weather, Settings, Marketplace, Geomtry Dash, etc...
* Per-player JSON persistence and world-level FS (`pc_ui_files.dat`)
* Wallpaper manager: solid colors, images, GIFs
* Tab Feature - If you have any open apps you can press Tab to see them All !
* Searchbar - On the Taskbar so you search for Apps
* Extensible: register custom apps/icons at runtime
* Performance: async IO and smart caching for smooth UX (coming fully for v.2.0.0)

_Note: The mod does not change gameplay - it adds a fully functional desktop inside Minecraft!
         Also beware ! Some Apps may be incomplete like the Calender, Browser and YouTube app
         Apps like the Browser App or YouTube app will be made Functional in a Addon in the future 
         since having a Real Browser Engine running is Very Performance heavy_

<div style="background-color: rgba(52, 152, 219, 0.1); border: 2px solid #3498db;"><h3 style="color: #3498db;">🆕 Version 1.0.0 - Initial Release 🎉</h3><strong>What's New:</strong><ul><li>✅ Placeable laptops open the in-game desktop</li><li>🖼️ Wallpaper picker, drag & drop support, window stacking & snapping</li><li>🧩 Core apps: Files, Notes, Notepad, Paint, Calculator, Calendar, Browser, Marketplace, Messenger, etc...</li><li>💾 Per-player JSON data and world FS for files</li><li>🛠️ App registration and icon customization APIs</li></ul></div>

<div style="background-color: rgba(26, 188, 156, 0.15); border: 3px solid #1abc9c;"><h2 style="color: #16a085; text-align: center;">💬 Frequently Asked Questions</h2><div><h4 style="color: #16a085;">🔄 Can I add this mod to an existing world?</h4><p style="margin-left: 15px;">Yes! Desktop and app data are stored per-player in JSON. You can safely add/remove this mod at any time, but always make backups.</p><h4 style="color: #16a085;">💾 How does file persistence work?</h4><p style="margin-left: 15px;">Files and app state are saved in <code>config/chaoscrafts_device_mod/players/<player>/</code> and world FS (<code>pc_ui_files.dat</code>). Wallpapers can be added to <code>run/chaoscrafts_device_mod/wallpapers/</code> for instant use.</p><h4 style="color: #16a085;">🖼️ Can I use custom wallpapers?</h4><p style="margin-left: 15px;">Absolutely! Just drop PNG/JPG/GIF images into the wallpapers folder.</p><h4 style="color: #16a085;">👥 How can I extend with my own apps or icons?</h4><p style="margin-left: 15px;">Use <code>AppFactory.registerApp(...)</code> and <code>IconManager.registerCustomIcon(...)</code> in your mod or datapack. ( There will be some Documentation soon so Devs can Create Custom Apps with Ease !</p></div></div>

<div style="background-color: rgba(52, 152, 219, 0.1); border: 2px solid #3498db;"><h3 style="color: #3498db;">🔧 Vital Fixes & Features</h3><ul><li>Full window management: dragging, minimizing, restoring, stacking, snapping</li><li>Taskbar with hover previews and app context menus</li><li>File browser and editor, Paint export to PNG, per-player notes</li><li>Live async stats & diagnostics for troubleshooting (will be fully for v.2.0.0)</li><li>Simple installation: just drop the jar in your mods folder and play!</li></ul></div>

<div style="background-color: rgba(76, 175, 80, 0.1); border: 2px solid #4CAF50;"><h3 style="color: #388e3c;">📊 Real-World Performance</h3><ul><li>Desktop loads instantly in-game</li><li>All app and file operations are async for smooth gameplay (will be fully for v.2.0.0)</li><li>Runs fast on both high-end and modest PCs</li></ul></div>

<div style="background-color: rgba(139, 195, 74, 0.1); border: 2px solid #8BC34A;"><h3 style="color: #689f38;">🎮 Compatibility</h3><ul><li>Minecraft 1.20.1 with Forge 47.4.0</li><li>Works with most modpacks</li><li>No resource pack needed for wallpapers - just drop images into the folder</li></ul></div>

<div style="background-color: rgba(104, 159, 56, 0.1); border: 2px solid #689F38; text-align: center;"><h3 style="color: #558b2f;">🌐 Community</h3><p>Need help or want to suggest an app? Join the BlackRift Studios Discord:<br><a style="color: #33691e; text-decoration: underline;" href="https://discord.gg/UPZ8BAJYvB" rel="nofollow">BlackRift Studios Discord</a></p></div>

<div style="background-color: rgba(155, 89, 182, 0.1); border: 2px solid #9b59b6;"><h3 style="color: #9b59b6;">👋 About</h3><p>Created by ChaosCraft - inspired by the idea of having a true desktop OS inside Minecraft, with full extensibility and local persistence for every player.</p></div>

<div style="background-color: rgba(128, 203, 196, 0.1); border: 2px solid #80CBC4; text-align: center;"><h3 style="color: #00897b;">⚖️ Usage Guidelines</h3><p>© 2025 ChaosCraft - All Rights Reserved<br><br><strong>Modpack & Server Usage:</strong><br>Free to include in modpacks/servers (attribution appreciated!). For large packs/servers, please reach out for a quick heads-up.<br><br><strong>Code Protection:</strong> Please respect code copyright. Collaboration and extension are welcome — reach out if you want to contribute or create custom apps.</p></div>

<div style="background-color: rgba(77, 182, 172, 0.1); border: 2px solid #4DB6AC; text-align: center;"><h3 style="color: #00796b;">💬 My Policy Explained</h3><p>This mod is designed to be open and extensible for the community, but please credit ChaosCraft for major features in large packs or public servers.</p></div>

<div style="text-align: center; background-color: rgba(46, 204, 113, 0.05);"><p style="font-size: 14px; color: #2e7d32;">ChaosCrafts Device Mod • Version 1.0.0-1.20.1 • Created by ChaosCraft • BlackRift Studios • October 1, 2025</p></div>