From 19e272f27a5eeb2be93e379081bf4d8dfd647d14 Mon Sep 17 00:00:00 2001
From: niri <niri@nekomimi.pet>
Date: Sat, 4 Jul 2026 01:29:59 -0400
Subject: [PATCH] docs: add README with modpack overview, categories, and
 install info

---
 README.md | 102 ++++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 102 insertions(+)
 create mode 100644 README.md

diff --git a/README.md b/README.md
new file mode 100644
index 0000000..0becf4a
--- /dev/null
+++ b/README.md
@@ -0,0 +1,102 @@
+# ComfyMC ²
+
+**Vanilla Plus** — a cozy Minecraft modpack for hanging out with friends.
+
+Minecraft **26.1.2** · NeoForge **26.1.2.76** · 64 mods
+
+## about
+
+ComfyMC is ana's minecraft server modpack — built for comfort, exploration, and looking at pretty things together. not a tech pack, not a magic pack, just vanilla with good vibes layered on top.
+
+the name is literal. this is about being comfy.
+
+## categories
+
+### performance
+- **sodium** — rendering pipeline replacement (the big one)
+- **iris** — shaders (pair with sodium)
+- **lithium** — general performance optimizations
+- **ferrite-core** — memory usage reduction
+- **immediatelyfast** — UI rendering speedup
+- **modernfix** — combined bugfix/perf patch
+- **entityculling** — skip rendering entities you can't see
+- **clumps** — merge XP orbs into single items
+- **sound-physics-remastered** — sound reverb/occlusion without the perf hit
+- **spark** — profiling/debug when you need to find what's slow
+
+### world generation
+- **terralith** — overworld terrain overhaul (dramatic but vanilla-feeling)
+- **biomes-o-plenty** — biome variety (dozens of new biomes)
+- **towns-and-towers** — village/tower structure generation
+- **yungs-better-mineshafts** — redesigned mineshafts that feel like places
+- **yungs-better-strongholds** — stronghold redesign
+- **yungs-better-dungeons** — dungeon variety
+- **terrablender** — biome generation API (dependency)
+- **tectonic** — custom worldgen config system
+- **explorify** — more world features to discover
+
+### visual / cosmetic
+- **3dskinlayers** — 2D skins get depth in 3D
+- **first-person-model** — see your own body in first person
+- **wavey-capes** — physics capes
+- **not-enough-animations** — smoother animations everywhere
+- **emoji-type** — emoji in chat/book&quill (because why not)
+- **chat-heads** — player faces next to chat messages
+- **advancement-plaques** — display advancements as item frames
+- **refurbished-furniture** — new furniture blocks
+- **macaws-bridges** — bridge blocks with actual shapes
+- **chisel-reborn** — decorative block variants
+- **ok-zoomer** — configurable zoom (hold to zoom)
+
+### quality of life
+- **appleskin** — hunger/saturation info overlay
+- **jei** — recipe viewer (just enough items)
+- **jade** — block/entity info tooltip
+- **searchables** — search containers (chests, etc.)
+- **mouse-tweaks** — better inventory interaction (drag, shift-click modes)
+- **controlling** — rebind any key freely
+- **easy-anvils** — no level requirement for renaming
+- **easy-magic** — enchanting improvements
+- **trade-cycling** — villager trade restocking tweaks
+- **trimmable-tools** — apply armor trims to tools
+- **axes-are-weapons** — axes use attack speed properly
+- **cut-through** — break multiple same-type adjacent blocks
+- **iceberg** — massive QoL library (lots of small fixes)
+- **freecam** — free camera mode (for screenshots)
+- **distanthorizons** — LOD rendering (see *far* away)
+
+### survival comfort
+- **comforts** — sleeping bags, hammocks, more ways to sleep
+- **sophisticated-storage** — upgraded chests with tiers and upgrades
+- **sophisticated-backpacks** — wearable inventory expansion
+- **guard-villagers** — villagers fight back (sort of)
+- **corail-tombstone** — keep your inventory on death (grave mechanic)
+- **serene-seasons** — passing seasons affect weather/crops
+- **natures-compass** — compass that points to specific biomes
+
+### libraries & frameworks (dependencies)
+- **puzzles-lib** — shared library for several mods above
+- **cloth-config** — config screen framework
+- **cristel-lib** — utility library
+- **cryonicconfig** — config freezing
+- **glitchcore** — shared utilities
+- **framework** — mod framework
+- **lithostitched** — worldgen scripting
+- **datapatched** — data-driven patches
+- **vivecraft** — VR support (if you have a headset)
+
+## install
+
+packwiz URL: `https://comfymc.wisp.place/pack.toml`
+
+add it to your packwiz-enabled launcher ( CurseForge, Prism Launcher, etc.) and it handles the rest.
+
+## server
+
+hosted on sharkgirl.pet — NeoForge server with 4GB allocated memory. dockerized via `itzg/minecraft-server`.
+
+## credits
+
+modpack created and maintained by [ana](https://bsky.app/profile/okami.mom) (okami.mom).
+
+all mods belong to their respective creators. this is just a collection of other people's good work arranged into a shape that feels like home.
-- 
2.51.2