Hades 2Loading...Hell2ModdingCG3H

This package has been deprecated and may no longer be maintained. We recommend looking for an alternative.

Install

Last Updated

First Uploaded

Downloads

Likes

Size

6.9MB

Dependency string

Enderclem-Hell2ModdingCG3H-3.9.0

Dependants

0 other mods

Libraries

Deprecated

Download

Details Required (0)Wiki Changelog Versions Analysis

Hell2ModdingCG3H — temporary fork of Hell2Modding

This is a temporary fork of Hell2Modding maintained by Enderclem to ship the patches CG3H v3.9.0 depends on, until those patches land in upstream.

Use upstream Hell2Modding instead once its next release includes these patches. This fork will be deprecated and delisted then.

What this fork adds

All changes are framework-level (not CG3H-specific). They're intended for upstream merge.

New Lua bindings (`rom.data.*`)

set_mesh_visible(entry_name, mesh_name, visible) — flip per-mesh visibility inside an entry by mutating its GMD+0x4C (mesh_type) byte. Instant, no draw call, no GPU state change. Main use: per-accessory toggle.
swap_to_variant(stock_entry, variant_entry) — install a hash remap so DoDraw3D reads variant_entry's data when a command queues stock_entry. Enables outfit switching without reloading models.
restore_stock(stock_entry) — clear the remap from swap_to_variant.
populate_entry_textures(entry_name) — mirror PrepDraw for entries the scene isn't actively walking (variant entries). Writes GetTexture(+0x40) into +0x44 so DoDraw3D's fallback resolves.
dump_pool_stats() — log per-shader-effect vertex-pool cursor + capacity and the global index-buffer cursor + capacity.
sanity_check_gmd(entry_name) — validate the hardcoded GrannyMeshData layout on demand. Logs ERRORs if offsets drifted from expected; used by CG3H as a first-frame canary.

Static pool patches (applied at DLL attach)

Two mov qword [rsp+X], imm32 byte patches raise the game's static GPU buffer budgets. Both buffers live in the DX12 upload heap (system RAM, not VRAM) so the cost is RAM, not GPU memory.

Vertex pool per shader effect: 64 MB → 128 MB (sgg::addShaderEffect 5th arg site).
Index pool global: 32 MB → 64 MB (sgg::addStaticVertexBuffers one-shot alloc site).

Without the patches, Hades II's default budget is too tight for mods that add mesh entries — later-loaded meshes (weapons, enemies) fall back to the Blank_Mesh placeholder. A plugin-init summary log reports [OK ] / [SKIP] per patch so a game update that shifts byte patterns is immediately visible.

Other

Shadow-cast code cave (VirtualAlloc-patched JMP at DoDraw3D + 0x148E4) so the shadow pass participates in hash remap alongside main/shadow/thumbnail.
draw.cpp module carves all the draw-dispatch hooks into a single file under lua::hades::draw.

Why a fork instead of waiting upstream

Hades II's modding scene moves fast and CG3H v3.9.0 is ready to ship. Keeping users gated on an open-source PR review timeline would delay the release indefinitely. The fork is scoped, narrowly-branded, and will be retired once upstream merges.

What it does NOT do

Not a replacement for upstream Hell2Modding. If you already have upstream H2M installed for other mods, installing this fork replaces its d3d12.dll — whichever is most recent wins. For users of CG3H + non-CG3H mods simultaneously: this fork's DLL is a strict superset of upstream (all upstream APIs still work), so other mods should continue to function. File an issue if not.
Not for general use. If you're not running a CG3H-dependent mod, install upstream Hell2Modding instead.

Upstream

Source: https://github.com/Enderclem0/Hell2Modding/tree/cg3h/v3.9.0
Upstream: https://github.com/SGG-Modding/Hell2Modding
CG3H: https://github.com/Enderclem0/CG3H

License

Same license as upstream Hell2Modding. See the repo LICENSE.

What this fork adds

All changes are framework-level (not CG3H-specific). They're intended for upstream merge.

New Lua bindings (rom.data.*)

set_mesh_visible(entry_name, mesh_name, visible) — flip per-mesh visibility inside an entry by mutating its GMD+0x4C (mesh_type) byte. Instant, no draw call, no GPU state change. Main use: per-accessory toggle.

swap_to_variant(stock_entry, variant_entry) — install a hash remap so DoDraw3D reads variant_entry's data when a command queues stock_entry. Enables outfit switching without reloading models.

restore_stock(stock_entry) — clear the remap from swap_to_variant.

populate_entry_textures(entry_name) — mirror PrepDraw for entries the scene isn't actively walking (variant entries). Writes GetTexture(+0x40) into +0x44 so DoDraw3D's fallback resolves.

dump_pool_stats() — log per-shader-effect vertex-pool cursor + capacity and the global index-buffer cursor + capacity.

sanity_check_gmd(entry_name) — validate the hardcoded GrannyMeshData layout on demand. Logs ERRORs if offsets drifted from expected; used by CG3H as a first-frame canary.

Static pool patches (applied at DLL attach)

Two mov qword [rsp+X], imm32 byte patches raise the game's static GPU buffer budgets. Both buffers live in the DX12 upload heap (system RAM, not VRAM) so the cost is RAM, not GPU memory.

Vertex pool per shader effect: 64 MB → 128 MB (sgg::addShaderEffect 5th arg site).

Index pool global: 32 MB → 64 MB (sgg::addStaticVertexBuffers one-shot alloc site).

Other

Shadow-cast code cave (VirtualAlloc-patched JMP at DoDraw3D + 0x148E4) so the shadow pass participates in hash remap alongside main/shadow/thumbnail.

draw.cpp module carves all the draw-dispatch hooks into a single file under lua::hades::draw.

What it does NOT do

Not a replacement for upstream Hell2Modding. If you already have upstream H2M installed for other mods, installing this fork replaces its d3d12.dll — whichever is most recent wins. For users of CG3H + non-CG3H mods simultaneously: this fork's DLL is a strict superset of upstream (all upstream APIs still work), so other mods should continue to function. File an issue if not.

Not for general use. If you're not running a CG3H-dependent mod, install upstream Hell2Modding instead.

Hell2ModdingCG3H

Details

Categories

Hell2ModdingCG3H — temporary fork of Hell2Modding

What this fork adds

New Lua bindings (`rom.data.*`)

Static pool patches (applied at DLL attach)

Other

Why a fork instead of waiting upstream

What it does NOT do

Upstream

License

Categories

Hell2ModdingCG3H — temporary fork of Hell2Modding

What this fork adds

New Lua bindings (`rom.data.*`)

Static pool patches (applied at DLL attach)

Other

Why a fork instead of waiting upstream

What it does NOT do

Upstream

License

Categories

Details

Categories

Hell2ModdingCG3H — temporary fork of Hell2Modding

What this fork adds

New Lua bindings (rom.data.*)

Static pool patches (applied at DLL attach)

Other

Why a fork instead of waiting upstream

What it does NOT do

Upstream

License

Categories

Hell2ModdingCG3H — temporary fork of Hell2Modding

What this fork adds

New Lua bindings (rom.data.*)

Static pool patches (applied at DLL attach)

Other

Why a fork instead of waiting upstream

What it does NOT do

Upstream

License

Categories

New Lua bindings (`rom.data.*`)

New Lua bindings (`rom.data.*`)