Disclaimer. This is an unofficial fan project. Harry Potter, Hogwarts, the wizarding-world setting, and all related names, characters, places, and indicia are trademarks of Warner Bros. Entertainment Inc., J.K. Rowling, and other rights holders. This mod is not affiliated with, endorsed by, or sponsored by any rights holder. Non-commercial fan use only — see License & IP disclaimer at the bottom.
Project status — design-complete, not yet playtested. All systems and content are designed and implemented in code, but the maintainer has not yet run a full in-game play-through inside tModLoader. The mod is not on Steam Workshop. The repository is open for collaborators — see Looking for help below — and is not currently a player-facing release.
A comprehensive Harry Potter Hogwarts experience mod for Terraria via tModLoader. 590 C# source files, 682 sprites, 1,576 project files. Canon-audited and redesigned with cleaner Hallows/Horcrux progression and stronger late-game consistency.
Core Identity: You are a Hogwarts student experiencing memories from across wizarding history through a Pensieve, learning spells, mastering your wand, and facing the rising darkness.
Highlights:
- 12 multi-phase bosses with Voldemort as the true final boss (Horcrux Hunt mechanic)
- Dark Arts Corruption System — dark magic is tempting but genuinely costly
- Wandlore System — 18 wood types, 5 cores, 9 spell schools
- Pensieve Memory Framework — solves mixed-era lore, enables boss replay
- Horcrux Hunt — destroy the 4 core Horcruxes, hunt Nagini, and weaken Voldemort before the final battle
- Master of Death — survival/fate-oriented hidden set bonus (not raw DPS)
- Utility Magic — Alohomora (opens doors), Reparo (ward/room repair), Accio (item attraction)
- Class Quest System — DADA, Potions, Creatures, Charms with mastery levels
- Quidditch Season — Seeker ranks, multi-Snitch events, broom trials
- Hogsmeade Village — worldgen town with Shrieking Shack
- Forbidden Forest — 3-zone depth scaling with progressive danger
- 78 enemies, 65 accessories, 8 armor sets, 5 mounts, 6 pets total, 19 potions
- 3-language support (English, Chinese Simplified, Chinese Traditional)
- Canon-audited: true Invisibility Cloak is unique, Gaunt's Ring awakens the Resurrection Stone, Demiguise gear is ordinary stealth gear
- Install tModLoader from Steam (free DLC for Terraria)
- Install the .NET 8 SDK if not already installed
- Copy the
WizardingWorldfolder to your tModLoader mod development directory:- Windows:
%userprofile%\Documents\My Games\Terraria\tModLoader\ModSources\
- Windows:
- Open tModLoader, go to Workshop > Develop Mods > Build + Reload
- The mod will compile and load automatically
When you first use a Life Crystal or defeat a boss, an owl will deliver your Hogwarts Acceptance Letter at dawn. This gives you a free Oak Wand and introduces the mod's systems.
Your first steps:
- Craft an Enchanting Table (Wood + Books + Fallen Stars + Amethyst) at a Workbench
- Use the Enchanting Table to craft better wands, potions, and magical gear
- Ollivander the wandmaker will move in once you have a wand
- Explore the world — a Wizard Tower has spawned with starter loot
- Defeat magical creatures to collect Essence of Magic (universal crafting material)
- Challenge the three wizard bosses: Basilisk, Hungarian Horntail, and Lord Voldemort
| Tier | Wands | Spells |
|---|---|---|
| Pre-Boss | Oak, Alder, Willow | Stupefy, Expelliarmus |
| Post-Eye | Ash, Holly, Vine, Rowan, Birch, Red Oak | Incendio, Protego, Wingardium, Aguamenti, Bombarda, Levicorpus, Riddikulus |
| Post-Skeletron | Phoenix Feather, Dragon Heartstring, Hawthorn, Blackthorn, Cedar, Cypress, Larch | Sectumsempra, Chain Stupefy, Impedimenta, Conjunctivitis, Lumos Maxima, Finite Incantatem, Accio |
| Hardmode | Unicorn Hair, Yew, Elm, Ebony | Patronus, Crucio, Reducto, Reparo, Apparition |
| Post-Golem | Elder Wand, Fiendfyre Wand | Avada Kedavra, Fiendfyre |
| Mastery Path | Elder Wand mastery title | "Wand of Destiny" remains flavor text, not a separate item |
| House | Weapon | Playstyle |
|---|---|---|
| Gryffindor | Sword of Gryffindor | Melee + Venom |
| Slytherin | Slytherin's Dagger | Fast crit + Jinxed |
| Ravenclaw | Ravenclaw's Staff | Low-mana spell + mana reduction |
| Hufflepuff | Hufflepuff's Mace | Life steal + defense |
| Boss | Tier | Drops |
|---|---|---|
| Basilisk | Pre-Hardmode | Basilisk Fang, Sword of Gryffindor, Basilisk Eye (Expert) |
| Hungarian Horntail | Hardmode | Dragon Scale, Golden Egg, Dragon Heart (Expert) |
| Dementor King | Post-Golem | Dementor's Shroud, Azkaban progression rewards |
| Lord Voldemort | Post-Lunatic Cultist | Elder Wand, Gaunt's Ring, Soul Fragment (Expert) |
Dementor, Acromantula, Cornish Pixie, Mountain Troll, Inferius, Thestral, Death Eater, Mandrake, Boggart, Doxy, Werewolf, Grindylow, Peeves, Nagini (mini-boss), Obscurus, Blast-Ended Skrewt, Sphinx, Giant, Snow Wraith, Cursed Mummy, Fwooper, Merfolk, Azkaban Guard, Bowtruckle (critter), Flobberworm (critter)
| NPC | Condition | Sells |
|---|---|---|
| Ollivander | Own a wand | Wands, Spell Book, crafting materials |
| Hagrid | Defeat Basilisk | Creature items, pets, boss summons |
| Potions Master | 4+ NPCs | All potions, ingredients |
| Dobby | 6+ NPCs | Sweets, utility items, consumables |
| Fred & George | Defeat Basilisk | ALL Weasley products, Marauder items |
| Centaur | Defeat any boss | Detection/divination items |
| Dumbledore | Defeat Dementor King | Hallows guidance, later endgame items |
- Deathly Hallows: true Invisibility Cloak, Resurrection Stone, Elder Wand
- Stealth Gear: Demiguise Weave Cloak, Camouflage Cloak, Stealth Draught
- Horcruxes: Riddle's Diary, Slytherin's Locket, Hufflepuff's Cup, Diadem of Ravenclaw
- Iconic Items: Philosopher's Stone, Time Turner, Marauder's Map, Triwizard Cup, Sorting Hat, Patronus Charm, Remembrall, Pensieve, Deluminator, Sneakoscope
- Marauder Items: Padfoot's Amulet (speed/stealth), Prongs' Charm (spell/summon boost)
- Weasley Products: Shield Hat, Extendable Ears
- Expert Boss Drops: Basilisk Eye, Dragon Heart, Soul Fragment
- Endgame: Master Wizard's Banner, Unbreakable Vow, Apparition Charm
- Vanity: Wizard Spectacles, Lightning Scar, Long Wizard Beard
| Set | Theme | Set Bonus |
|---|---|---|
| Gryffindor | Damage | +15% damage, +10% melee speed |
| Slytherin | Crit | +12% crit chance |
| Ravenclaw | Magic | +20% spell damage, +40 mana, mana regen |
| Hufflepuff | Tank | +8 defense, +4 life regen, 30% thorns |
| Dark Wizard | Spell Power | +25% spell damage, +15% spell crit |
| Dragon Scale | Hardmode Spell | Fire/lava immunity, +18% spell damage |
| Wizard Robes | Vanity | Classic wizard aesthetic |
- Mounts: Nimbus 2000 → Firebolt → Hippogriff → Nimbus 2001 (all flying, clear upgrade path)
- Pets: 6 total, including 1 light pet — Golden Snitch, Niffler, Hedwig, Kneazle, Pygmy Puff, Baby Dragon
- Minions: Phoenix (heals + attacks), House-Elf (teleports), Patronus Guardian (anti-Dementor, 2 slots)
Butterbeer, Felix Felicis, Polyjuice, Wolfsbane, Veritaserum, Amortentia, Gillyweed, Pepperup, Skele-Gro, and more
- Death Eater Invasion — 3-wave night event, trigger with Dark Mark or random
- Azkaban's Despair — prison-break survival event with despair buildup, Patronus dependence, and ward play
- Quidditch Snitch Chase — catch the Golden Snitch on a broomstick for rewards
- Forbidden Forest Biome — unique spawn pool at night in forests (post-Basilisk), exclusive Unicorn Blood drops
- Wizard Tower — world-gen structure with starter loot
- Hogwarts Letter — intro system for new players
- Essence of Magic — universal crafting material from all magical creatures
- ModConfig — customizable spawn rates, boss HP, damage scaling
| Debuff | Effect | Applied By |
|---|---|---|
| Petrified | Complete immobility | Basilisk, Sphinx, Giant |
| Jinxed | -20% damage, -15% speed, -5 defense | Impedimenta, Boggart, Decoy Detonator |
| Dark Curse | 8 HP/sec DoT, blocks healing, -10 defense | Voldemort, Death Eaters, Cursed Mummy |
Access mod settings via Settings > Mod Configuration > Wizarding World:
- Enemy Spawn Multiplier (0.1x - 5.0x)
- Boss Health Multiplier (0.5x - 5.0x)
- Spell Damage Multiplier (0.5x - 3.0x)
- Death Eater Invasion Chance (0x - 5.0x)
- Essence Drop Multiplier (0.5x - 5.0x)
The included in-game sprites are complete and release-checked. Asset coverage is tracked in tools/generated_batches/manual_review_done.txt, and scripts/verify_assets.py checks PNG readability, manual-review coverage, key-color residue, Buff icon sizing, and unexpected oversized files.
- Mod Development: Built with Claude Code (Anthropic)
- Game: Terraria by Re-Logic
- Modding Framework: tModLoader
- Inspiration: J.K. Rowling's Harry Potter series, Fantastic Beasts
This mod is design-complete in code but not yet gameplay-verified. Before any player-facing release (Steam Workshop), it needs collaborators in the following areas. If any of these match what you'd like to work on, browse open issues or open a new one — see CONTRIBUTING.md for build setup.
| Need | What it looks like | Label |
|---|---|---|
| Playtesters | Run a full play-through (or one boss fight, one biome, one questline). File issues for crashes, missing assets, broken progression, or balance problems. | playtest needed |
| Multiplayer-sync verifiers | Specifically test Common/Players/ and Common/Systems/ paths in 2+ player co-op (save/load, host-vs-client desyncs). |
multiplayer-sync |
| Balance reviewers | Review the 23 wands × 5 cores DPS / mana spread, 12 boss HP curves, drop rates. Flag obvious outliers. | balance |
| Sprite artists | Replace or polish placeholder SVG sprites in Assets/SVG/. Style is line-art monoline indigo. |
sprite-polish |
| Localizers | Native-speaker review or new-language translation of the three HJSON files in Localization/. Currently English / Simplified Chinese / Traditional Chinese. |
localization |
| Canon-audit reviewers | Cross-check content against HarryPotterModCatalog.txt for canon consistency or design suggestions. |
audit |
Issues are tagged with the labels above. The maintainer has limited bandwidth, so:
- Take ownership — comment "I'll take this" on an issue, work on a fork, open a PR.
- Small first PR — a single sprite polish, a typo fix, a balance tweak with rationale. Big rewrites need an issue first.
- Discussions — design questions / ideas / "should we do X?" go in GitHub Discussions, not issues.
The original code, configuration, and self-created assets in this repository (C# source, build scripts, SVG sprites, audio created for this mod) are released under the MIT License.
This is an unofficial fan project. Harry Potter, Hogwarts, the wizarding-world setting, and all related names, characters, places, and indicia are trademarks of Warner Bros. Entertainment Inc., J.K. Rowling, and other rights holders. This mod is not affiliated with, endorsed by, or sponsored by any rights holder. The MIT license above applies only to the original code and self-created assets — it does not, and cannot, license any third-party intellectual property referenced by name within the mod.
Terraria is © Re-Logic. tModLoader is community-maintained. Neither is affiliated with this mod.
See CONTRIBUTING.md for build setup, code style, and what's in / out of scope. Architecture-level guidance lives in CLAUDE.md and AGENTS.md.