Repository navigation
NVForever v0.6.0
Pre-releaseThe sixth NVForever pre-release: everything merged since v0.5.1 (2026-10-29), about 270
pull requests. The main news is script extender support built into the engine (xNVSE,
JIP LN, JohnnyGuitar and a dozen smaller libraries, no DLLs), Bevy 0.20 and a large
performance pass (water reflections, shadows, LOD and loading), the Tale of Two
Wastelands opening, and many AI, combat, HUD and menu fixes checked against the original.
You need your own copy of Fallout: New Vegas (1.4.0.525, base game + all DLC). No game
data is included. Unpack anywhere outside the game folder and run nvforever.exe (or
nvforever.cmd; ./nvforever.sh on Linux). The first start asks for your game folder and
remembers it, and the game opens on the main menu. README-release.md in the archive
explains the rest. NVForever never writes into the game folder or
Documents\My Games\FalloutNV; its own home is Documents\My Games\NVForever.
Script extenders: NVForever runs the script functions, syntax and events of xNVSE, JIP LN,
JohnnyGuitar and the libraries listed below as part of the engine. NVSE plugin .dll files
are never loaded, so a mod that relies on a plugin's engine patches, or on a function not
built yet, may still not work.
New since v0.5.1
Engine and performance
- Upgraded to Bevy 0.20.1; the vendored bevy_pbr is gone (#939). Unused Bevy plugins are switched off (#1405). Fixed a GPU memory leak in long sessions (#905).
- Water reflection camera runs only while water is on screen, judged by a GPU water-pixel count (Primm 51 → 80 fps), and can be turned off in settings (#1047, #1065, #1066, #1403).
- Shadows: sun cascades draw only the casters over their slice of the view, use 2048² maps, and the moon uses one cascade (#1371, #1418, #1419). The arms shade light is about 3 ms cheaper (#1397). Ambient occlusion runs at half resolution (#1402).
- LOD: object blocks and terrain chunks are built on worker threads, kept to a rebuild budget, and terrain no longer starves object blocks (#1044, #1052, #1121).
- Loading and memory: JIP record fields are decoded on first use (heap 507 → 207 MB). Script data loads in slices. Archives inflate outside the lock, and collision loading shares shapes between copies (#1105, #1123, #1153, #1360). Asset cache limits follow RAM and the GPU budget (#1169, #1218). Interior stalls are fixed (#1440).
- Fewer per-frame costs in physics hit volumes, the character controller, AI obstacle polls, animation, effect shaders, ripples, particles, the script runtime, the UI tree and sound decoding (#1099, #1321, #1343, #1347, #1431, #1437, #1445, #1446, #1449, #1489, #1490, #1492, and others).
- Game text is read in the install's own code page (1252, 1251 or 1250) (#1441). Files open whatever the case of their names (#1137).
SArchiveListin NVForever.ini replaces the shipped base list (#1214).
Gameplay and AI
- Combat: melee knockback (#1219). Attack clips that travel carry their actor, such as the Deathclaw lunge (#1209). Combat groups share alarms and targets (#1288). VATS hit chance is fitted to the original, and VATS has a kill camera (#1195, #1368). Explosions damage every limb (#1350). NPC weapon choice weighs explosives properly (#1304).
- Movement: player speed follows Speed Mult and armour (#1373). Falls hurt one leg and play the hard-landing sound (#1231). Jump and land footsteps play (#1215). Creatures turn at the data's rate (#1278). Coyotes warn and bite as they do in the original (#1190).
- AI: NPCs stop and face a load door before going through it (#1481). They are already at their package's place after a fast travel or a load door (#1269). New and fixed behaviour for Guard and Remain Near packages (#1202), Avoid Radiation (#1200), Observe Combat spectators running from a fight (#1216), the No AI Acquire flag (#1118), sandbox recovery after a fight (#1508), and leg-posing idles that NPCs break out of to walk (#1175).
- Detection, crime and karma: detection survives a save and load (#1265). Companions no longer set [DETECTED] (#1247). Unseen, silent targets no longer lower the detection value (#1150). Witnesses who ignore crime say the NoCrime topics (#1198). Killing an Evil character gives +100 karma (#1234).
- Needs and Hardcore: needs rise in whole points per waited hour, sleep heals Health, and Stimpak effects are fixed (#1178, #1271, #1442).
- World: dropped weapons fall at once and show in corpse loot (#1136, #1140). Destroyed car parts fall (#1413). Animated objects keep their collision, and gates left open reload open (#1433). Scripted moves of clutter stick (#1316). Script triggers follow moved references (#1141). A save made high up loads at its height (#1243).
- Dialogue and voice: Speech successes and failures are counted (#1298). Lines that plugins add follow their Previous INFO (#1199). Equal-priority topics are ordered newest learned first (#1205). Goodbye scripts can start the next conversation (#1249). Seated NPCs greet from their seat (#1480). Robots light up as they talk (#1201). Voices take the room's reverb (#1281). Template voices are fixed (#1116).
- Quests: ResetQuest and objective fixes (#1233, #1244). Five batches of headless walkthroughs, with their stalls fixed (#930, #933, #941, #1147, #1263, #1289, #1301).
UI, HUD and menus
- HUD: corrected against captures from the original (bars, compass, radiation, enemy bar rule) (#902, #942). Notices are drawn from tiles and hidden behind menus. Fonts sit on per-font baselines (#952, #1040, #1135, #1166, #1236, #1245). A corner notice appears for new notes (#1259).
- UI tile tree (behind
[UI] TileMenus): game strings table, pointer and keys, the remaining tile functions, and these menus drawn from their menu files: message box, quantity prompt, Wait/Sleep, tutorial (with a blurred background) and the pause menu's Mods page (#954, #957, #1005, #1045, #1223, #1224, #1307, #1308, #1493, #1495). - Pip-Boy: full-screen menu option (#1229). In ITEMS, right click drops and controller buttons match the original (#1411). List clicks work on STATS and DATA (#1348), and layout is fixed (#1344, #1331).
- Settings: frame rate counter (#1095), crosshair style (#1097), variable refresh (G-Sync/FreeSync) (#1217), Invert Y and separate mouse and controller sensitivity (#1453), and controller aim assist (#1266). The page fits the view (#1260). Sound defaults match the original (#1456).
- Menus use their words from the game's strings (chargen name, reputation box, How many?, hacking) (#1182, #1188, #1313). Level-up music plays (#1193). The weapon wheel clicks (#1194). The reputation box and level-up menu wait until 2 s after a fight (#1207). The terminal screen has a new look (#1293).
Script extenders (xNVSE, JIP LN and others built into the engine)
- The extender compiler and lab have landed (#928, #944), and the remaining core xNVSE functions are built, including PrintActiveTile (#1068).
- JIP LN batches 4–7 (#956, #1003, #1145, #1354, #1358) and the JIP Script Runner (#1469).
- JohnnyGuitar batches 1–4 (#1064, #1102, #1328, #1333).
- Smaller libraries: ITR (all 119), One111 (51), ppNVSE (42), SUP batch 1, NX, Anh, ShowOff, kNVSE (with AnimGroupOverride folders), JIP PP LN, vheyes, CacheUI and MCM (#1043, #1240, #1284, #1285, #1287, #1290, #1291, #1295, #1363, #1479).
- Script fixes: format variables, inline declarations, lambdas, self-holding arrays, template getters (#1071, #1119, #1120, #1225, #1267, #1310, #1476).
- New console commands: killall, cow/coe, saq, rdf, rat, zap, tlik, temo, tfow, slpm, bat, MFG, plm/clm, s1st, SetVel and others (#1212, #1220, #1226, #1272, #1294).
Tale of Two Wastelands
- The TTW opening works: birth scene, baby stage, S.P.E.C.I.A.L. menus and gene projector (#1407). Fallout 3-only script functions are built (#1455, #1475). The TTW stack overflow (#1462) and the TTW sky colours (#1423) are fixed.
Visual fixes
- Hair is drawn as cut-outs (#1458). One hand model per hand (#1157, #1372). Dismemberment caps are hidden by partition (#1155). Blood spray shows on actors (#1268). The jukebox and radio dials light correctly (#1158, #1211). Radio plays at full level (#1165). Untextured grass on CRLF checkouts is fixed (#949).
Tools and development
- Tracy profiling, a 51-scenario profiling campaign, frame telemetry export and render and physics breakdowns (#1306, #1314, #1332, #1376, #1385, #1422, #1482).
- A design for code mods as WebAssembly plugins (#1399).
- Observer checks answered from the original, smoke and CI fixes, the issue-first procedure, and legal hygiene (#920, #921, #924, #927, #1126, #1168, #1320, #1335–#1353, #1478, #1515, and others).
Not built yet
Loading NVSE plugin DLLs (never planned) and the extender functions not built yet, menus
drawn from the game's menu files beyond the ones above (behind [UI] TileMenus, off by
default), exterior cloud placement, and the rest of the gaps listed in docs/status.md and
docs/outstanding.md in the repository.
State by layer
| Layer | Scope | State |
|---|---|---|
| 1 | BSA reader, ESM/ESP parser, load order, schemas | done |
| 2 | NIF, DDS, KF assets, viewer | done |
| 3 | World and rendering | done, with known gaps: exterior clouds |
| 4 | Core simulation, collision, physics, play | done; 3 accepted physics residuals |
| 5 | Scripting | done; script extenders (xNVSE, JIP LN, JohnnyGuitar and others) built in, partly |
| 6 | Gameplay: AI, dialogue, combat, followers, crime, aid, progression | mostly done |
| 7 | Interface, audio, saves | mostly done; the menu engine (tile tree) started |
Report bugs and differences from the original with the issue forms on GitHub. Never attach
game files.