mirror of
https://github.com/Outer-Wilds-New-Horizons/new-horizons.git
synced 2025-12-11 20:15:44 +01:00
b325f87f5f
<!-- A new module or something else important -->
## Major features
- NOTE: "nomaiText" has been deprecated in order to preserve the legacy
nomai text generation. Please use "translatorText" in the future, it is
exactly the same except it lets you use the new automatic spiral
placement, caching, and so on
- Caching!
- Lots to say about this, both for nh devs and addon devs
- Addon Devs:
- This feature introduces new .nhcache files, which New Horizons will
generate automatically. One nhcache file will be generated per planet
- Make sure to include these files when releasing your addon. This will
allow your players to have fast loading times on their first loop. If
you forget to include them, no worries, their first loop will be slow to
load but every following loop will be fast.
- ~~WARNING: before releasing, delete all your cache files and
regenerate them by opening the game~~
- ~~the reason for this is that as you develop, your caches will get
filled up with old data. Deleting them and letting them regenerate keeps
your release light~~
- Cache files automatically clear unused entries, so there's no need for
you to manage them, they should stay minimal on their own
- NH Devs:
- Checkout the Cache property on NewHorizonBody. Use it how you want,
whether that's storing procedurally generated meshes or the private key
you brute forced using a botnet you embedded in new horizons.
- Actually scratch that second usecase. Caching doesn't support illegal
activity
- For an example of an actual use of caching, check out
NomaiTextBuilder.MakeArc()
- Also read the section for Addon Devs if you haven't
- How does auto spirals use the cache?
- When building a wall text, the cache is checked to see if it has been
built before, and if so, is loaded from there
- Whenever a NomaiTextArcInfo in the json is changed, the corresponding
wall text generates a new entry in the cache
- Also, whenever an xml file used by a wall text is changed, that wall
text will generate a new entry in the cache
- These old entries do accumulate during development of an addon, so
please make sure to check the note above for addon devs for how to deal
with that
- New Horizon's Nomai text arcs are now procedurally generated
- Automatic Nomai text arc placement!
- Nomai wall text is now automatically arranged to fit on a whiteboard,
no need to place text manually anymore!
- Manual placement is still supported if you want it
- If you want to specify certain arcs to be written by children (or
strangers) instead of adults without requiring manual placement, use the
"keepAutoPlacement" property of ArcInfo
- I hope this feature makes wall text less intimidating to include in
addons, I know it'll save me literal hours
- Despite being listed last here, this is the actual main feature of
this PR
<!-- A new parameter added to a module, or API feature -->
## Minor features
-
<!-- Some improvement that requires no action on the part of add-on
creators i.e., improved star graphics -->
## Improvements
- Everything technically goes here too, except maybe caching. Auto
spiral placement is automatic unless overriden by specifying arcInfo
(without using the "keepAutoPlacement" property)
<!-- Be sure to reference the existing issue if it exists -->
## Bug fixes
-
Do you want to create planets using New Horizons? Then check out our website for all our documentation!
If you want to see examples of what NH can do check out the examples add-on or real solar system add-on.
Check the ship's log for how to use your warp drive to travel between star systems!
Incompatible mods
- Quantum Space Buddies.
- OW Randomizer.
Supported Mods
New Horizons has optional support for a few other mods:
- Discord Rich Presence: Showcase what New Horizons worlds you're exploring in your Discord status!
- Voice Acting Mod: Characters in NH can be given voice lines which will work with this mod installed. Try it out by downloading NH Examples and talking to Ernesto!
- Achievements+: New Horizons and its addons have achievements you can unlock with this mod installed!
Features
- Load planet meshes or details from asset bundles
- Use our template Unity project to create assets for use in NH, including all game scripts recovered using UtinyRipper
- Separate solar system scenes accessible via wormhole OR via the ship's new warp drive feature accessible via the ship's log
- Remove or edit existing planets, including what they orbit around
- Create custom planets from heightmaps/texturemaps
- Create stars (and supernovae), comets, asteroid belts, satellites, quantum planets/moons, and custom Dark Bramble dimensions.
- Add stock planet features to custom ones, such as geysers, cloak fields, meteor-launching volcanoes, rafts, tornados, and Dark Bramble seeds/nodes.
- Binary orbits
- Signalscope signals and custom frequencies
- Surface scatter: rocks, trees, etc, using in-game models, or custom ones
- Black hole / white hole pairs
- Custom dialogue, slide-reel projections, translatable text, and custom ship log entries for rumour mode and map mode
- Funnels and variable surface height (can be made of sand/water/lava/star)
Development
If you want to help (please dear god help us) then check out the contact info below or the contributing page.
The Unity project we use to make asset bundles for this mod is here.
Contact
Join the Outer Wilds Modding Discord if you have any questions or just want to chat about modding! Theres a New Horizons category there dedicated to discussion of this mod.
Credits
Main authors:
- xen (New Horizons v0.1.0 onwards)
- Bwc9876 (New Horizons v0.9.0 onwards)
- Mister_Nebula (Marshmallow v0.1 to v1.1.0)
New Horizons was made with help from:
- FreezeDriedMangos
- MegaPiggy
- JohnCorby
- Nageld
- Trifid
- Raicuparta
- jtsalomo
- And the Outer Wilds modding server.
Translation credits:
- Russian: Tlya
- German: Nolram
- Spanish: Ciborgm9, Ink, GayCoffee
- French: xen
Marshmallow was made with help from:
- TAImatem
- AmazingAlek
- Raicuparta
- and the Outer Wilds discord server.