ReyEngine

KO | EN

gitlite — search

#redis #command-line #llm #reactjs #awesome #ruby #pdf #proxy #postgresql #framework

(★ 9)

A modern map & asset editor for League of Legends mods

File Explorer

ZIP Download

- - release.yml
- - README.md
- - Live.json
  - PBE.json
- - v0.1.8.md
  - v0.1.9.md
  - v0.2.0.md
  - v0.2.1.md
  - v0.2.10.md
  - v0.2.2.md
  - v0.2.3.md
  - v0.2.4.md
  - v0.2.5.md
  - v0.2.6.md
  - v0.2.7.md
  - v0.2.8.md
  - v0.2.9.md
  - v0.3.0.md
  - v0.3.1.md
  - v0.4.0.md
  - v0.4.1.md
  - v0.4.2.md
  - v0.4.3.md
  - v0.4.4.md
  - v0.4.5.md
  - v0.4.6.md
  - v0.4.7.md
- - bit2-tft-skybox-data.txt
  - bit2-tft-skybox.md
  - d3d11-spike.md
  - dx11-shader-preview.md
  - frame-pipeline.md
  - legacy-audio.md
  - legacy-decals.md
  - light-system.md
  - navgrid.md
  - particles-dat.md
  - q1-blendmodes-data.txt
  - q1-blendmodes.md
  - q4-miscrenderflags-data.txt
  - q4-miscrenderflags.md
  - renderdoc-capture-plan.md
  - renderer-architecture-plan.md
  - save-architecture.md
  - troybin-rosetta.md
  - vaxis-bisection.md
  - vfx-blend-modes.md
  - vfx-draw-order.md
  - vfx-flipbook-uv-ramp.md
  - vfx-preview-rig.md
  - vfx-support-report.md
  - vfx-texture-slots.md
  - viewport-migration-plan.md
- - about.png
  - editor-main.webp
  - model-preview-dominion.webp
  - new-project-wizard.png
  - particle-editor.png
  - project-settings.png
  - setup-wizard.png
- gl-shader-parity.md
- map-state-transitions.md
- reyengine_logo.png
- reyengine_logo_wide.png
- roadmap-v0.4.0.md
- Package.wxs
- ReyEngine.Installer.wixproj
- - App.axaml
  - App.axaml.cs
  - app.manifest
  - AppInfo.cs
  - Program.cs
  - ReyEngine.App.csproj
- - ReyEngine.Core.csproj
  - ReyPaths.cs
- - ReyEngine.Formats.csproj
- - GridRenderer.cs
  - MapGeoRenderer.cs
  - MeshRayIndex.cs
  - OrbitCamera.cs
  - ReyEngine.Rendering.csproj
  - ShaderUtil.cs
  - SkyboxRenderer.cs
  - ViewFrustum.cs
  - ViewportMeshRenderer.cs
  - ViewportPicking.cs
- - BloomChain.cs
  - ExperimentalDynamicEffectLightmapShader.cs
  - ExperimentalSrxBlendLightmapShader.cs
  - IconGlyphs.cs
  - ParticleQuadBuilder.cs
  - ParticleShading.cs
  - PreviewGeometry.cs
  - ReyEngine.Rendering.D3D11.csproj
  - ShaderPreviewRenderer.Bloom.cs
  - ShaderPreviewRenderer.ClusterLights.cs
  - ShaderPreviewRenderer.cs
  - ShaderPreviewRenderer.DebugViews.cs
  - ShaderPreviewRenderer.DynamicLights.cs
  - ShaderPreviewRenderer.Ribbon.cs
  - ShaderPreviewRenderer.Shadow.cs
  - ShaderPreviewRenderer.Sky.cs
  - SunShadowFit.cs
- - AddedMeshMaterialPickerTests.cs
  - AddMeshSamplerSetupTests.cs
  - AddMeshSelectionTests.cs
  - AddPropTests.cs
  - ArenaBackdropTests.cs
  - ArenaTests.cs
  - AssetTypeDetectorTests.cs
  - AttackCompositeTests.cs
  - BakedTerrainBindingTests.cs
  - BinAssetLinkMigrationTests.cs
  - BinEmptyPropertyTests.cs
  - BinNullStructRepairTests.cs
  - BinObjectGraphImporterTests.cs
  - BinRoundTripTests.cs
  - BinValidatorSchemaTests.cs
  - BlenderAddonInstallerTests.cs
  - BlenderAddonWireTests.cs
  - BlenderBridgeServerTests.cs
  - BlenderBridgeTests.cs
  - BlendFactorGuardTests.cs
  - BlendFactorPairingTests.cs
  - BlockCompressedTextureSizeTests.cs
  - BloomChainTests.cs
  - BonePaletteTests.cs
  - BottomDockTests.cs
  - BucketGridStalenessTests.cs
  - CastControlTests.cs
  - CastFrameAndPaletteTests.cs
  - ChampionAttackTests.cs
  - ChampionRenderStateTests.cs
  - ChampionRigTests.cs
  - ChampionSpellDataTests.cs
  - ChampionStatsTests.cs
  - CharacterActionPanelTests.cs
  - CharacterActionTests.cs
  - CharacterBrowserTests.cs
  - CharacterCatalogTests.cs
  - CharacterControllerTests.cs
  - CharacterControlPanelTests.cs
  - CharacterCreatorTests.cs
  - CharacterCullingTests.cs
  - CharacterDx11DummyTests.cs
  - CharacterDx11MovementTests.cs
  - CharacterDx11OverlayTests.cs
  - CharacterDx11SurfaceTests.cs
  - CharacterFolderImportTests.cs
  - CharacterFormatTests.cs
  - CharacterMaterialEditorTests.cs
  - CharacterMaterialTests.cs
  - CharacterOutlinerTests.cs
  - CharacterPackageTests.cs
  - ChildSpawnIndexTests.cs
  - CinematicCaptureTests.cs
  - CinematicDocumentTests.cs
  - CinematicPanelTests.cs
  - CinematicPathTests.cs
  - CinematicProjectionTests.cs
  - CleanupTests.cs
  - ClientDepthRulesTests.cs
  - ClusterLightBuilderTests.cs
  - DecalDrawOrderTests.cs
  - DepthPushAndRollTests.cs
  - DepthTestFlagTests.cs
  - Dx11AnimationTests.cs
  - Dx11CharacterSceneTests.cs
  - Dx11DebugViewTests.cs
  - Dx11OverlayGateTests.cs
  - Dx11ParticleConstantsTests.cs
  - Dx11ReanchorTests.cs
  - Dx11SamplerAddressTests.cs
  - Dx11ViewportCacheTests.cs
  - DynamicLightBatchTests.cs
  - DynamicPointLightTests.cs
  - EditorSettingsTests.cs
  - EmbeddedElementTests.cs
  - EncryptedAssetTests.cs
  - ErosionSamplerTests.cs
  - ExperimentalShaderPatchTests.cs
  - ExtendedChannelRuleTests.cs
  - ExtendedTextureDecoderTests.cs
  - FaceEditModeTests.cs
  - FantomeImporterSafetyTests.cs
  - FlipbookAndUvRampTests.cs
  - FrameDiffTests.cs
  - FrustumCullTests.cs
  - GameReferenceLibraryTests.cs
  - GgxPointLightTests.cs
  - GizmoArmSpaceTests.cs
  - GizmoArrowTests.cs
  - HashDbConcurrencyTests.cs
  - HashDbFileTests.cs
  - HashDbTestWriter.cs
  - InstallerPackageTests.cs
  - LegacyAlphaClassifierTests.cs
  - LegacyAlphaRepairTests.cs
  - LegacyAssetIndexTests.cs
  - LegacyAudioInjectionTests.cs
  - LegacyAudioPortTests.cs
  - LegacyDecalGeometryTests.cs
  - LegacyDecalQuadTests.cs
  - LegacyImportSelectionTests.cs
  - LegacyMapPorterTests.cs
  - LegacyParticlePlacementTests.cs
  - LegacyParticlePortTests.cs
  - LegacyPortNamingTests.cs
  - LegacyPortRegressionTests.cs
  - LegacyPortSettingsMemoryTests.cs
  - LightBakeCoverageTests.cs
  - LightFitTests.cs
  - LightGridCharacterBrightnessTests.cs
  - LightRangeRingTests.cs
  - LightRegionInfoBuilderTests.cs
  - LtkWorkshopExporterTests.cs
  - MacroEditorPersistenceTests.cs
  - MacroSupportBadgeTests.cs
  - MapBucketGridHeightRangeTests.cs
  - MapCharacterListTests.cs
  - MapContentDeleteCommandTests.cs
  - MapGeoFaceGrowerTests.cs
  - MapGeoFaceWriterTests.cs
  - MapGeoMaterialWriterTests.cs
  - MapGeoMeshImporterTests.cs
  - MapGeoMeshReshaperTests.cs
  - MapGeoSaveGateTests.cs
  - MapGeoSubmeshCompactionTests.cs
  - MapGraphicsFeatureTests.cs
  - MapLightingArtefactTests.cs
  - MapLightingModeTests.cs
  - MapMaterialAuditTests.cs
  - MapMaterialDepthWriteTests.cs
  - MapMaterialFactoryTests.cs
  - MapParticleBudgetTests.cs
  - MapParticleDrawOrderTests.cs
  - MapPlaceableWriterTests.cs
  - MapSkinCharacterSwapTests.cs
  - MapSkinSwitcherTests.cs
  - MapStateDataTests.cs
  - MapStateTransitionTests.cs
  - MapSunWriterTests.cs
  - MapVisibilityTests.cs
  - MaterialBulkEditTests.cs
  - MaterialCleanupTests.cs
  - MaterialContainerShapeTests.cs
  - MaterialDriverStateTests.cs
  - MaterialMacroEditingTests.cs
  - MaterialMacroIdentityTests.cs
  - MaterialPresetTests.cs
  - MaterialShaderConverterTests.cs
  - MaterialSwitchWireShapeTests.cs
  - MeshBackfaceCullTests.cs
  - MeshMaterialSelectionTests.cs
  - MeshStageParityTests.cs
  - MeshTangentTests.cs
  - MeshUvChannelEditorTests.cs
  - MeshUvChannelTests.cs
  - MetaClassDatabaseTests.cs
  - MetaDefaultPropertyTests.cs
  - MimirLayeringTests.cs
  - ModShapeValidatorTests.cs
  - NavGridPathTests.cs
  - NavGridTests.cs
  - NeutralLightGridTests.cs
  - NewFeatureHighlightTests.cs
  - NewFeatureRegistryWiringTests.cs
  - NoBakedLightingFixTests.cs
  - NvrMaterialTypeTests.cs
  - OnsenCharacterTests.cs
  - OpenGlFrustumCullTests.cs
  - OrbitCameraNearTests.cs
  - ParticleBulkEditTests.cs
  - ParticleCurveEditorTests.cs
  - ParticleEditorLayoutTests.cs
  - ParticleEditorSpreadUiTests.cs
  - ParticleFlipbookAndWarmupTests.cs
  - ParticleListEditTests.cs
  - ParticleMaskStageTests.cs
  - ParticleMultiplierAtlasTests.cs
  - ParticlePrimitiveRowTests.cs
  - ParticleQuadBuilderTests.cs
  - ParticleShadingTests.cs
  - ParticleSpreadRowTests.cs
  - PatchAutoUpdateTests.cs
  - PlacementDirtyFlagTests.cs
  - PlacementEditVerbTests.cs
  - PlacementTintTests.cs
  - PointLightFalloffTests.cs
  - PortedDecalAlphaCutTests.cs
  - PortedDecalBlendStateTests.cs
  - PorterEmbeddedOutputTests.cs
  - PreviewVertexLayoutTests.cs
  - ProjectAssetPathNamingTests.cs
  - ProjectBuildBoundaryTests.cs
  - ProjectFileWinsOverOverrideTests.cs
  - PropAnimationChoiceTests.cs
  - PropAnimationResolutionTests.cs
  - PropGlMaterialTests.cs
  - PropLightGridTests.cs
  - PropMoveTests.cs
  - PropParticlePerfTests.cs
  - PropRiotShaderTests.cs
  - PropTextureCatalogTests.cs
  - RangeRingTests.cs
  - ReyEngine.Formats.Tests.csproj
  - RiotMeshEmitterTests.cs
  - RiotTypoFieldsTests.cs
  - RitobinEditorViewModelTests.cs
  - RitobinTextReaderTests.cs
  - RitobinTextWriterTests.cs
  - SamplerAddressEditTests.cs
  - SamplerAddressTripleTests.cs
  - SaveRebaseTests.cs
  - SchemaFieldAddTests.cs
  - SchemaFieldRoundTripTests.cs
  - SessionLogTests.cs
  - ShaderCacheNamingTests.cs
  - ShaderCacheTests.cs
  - ShaderCatalogCacheTests.cs
  - ShaderDefinitionDefaultsTests.cs
  - ShaderDescriptionTests.cs
  - ShaderFamilyTests.cs
  - ShaderQualityTests.cs
  - ShaderStagePairingTests.cs
  - SkinBlockSettingsTests.cs
  - SknStaticImportTests.cs
  - SmallThingsTests.cs
  - SpellAimTests.cs
  - SpellClipBindingTests.cs
  - SpellVariantPreviewTests.cs
  - SunShadowFitTests.cs
  - TexEncodeOptionsTests.cs
  - TextureImportViewModelTests.cs
  - TextureRecolorServiceTests.cs
  - TextureReferenceLoadingTests.cs
  - TexWriterDdsTests.cs
  - ThemeLookTests.cs
  - TroyBinTests.cs
  - TroyColorCurveTests.cs
  - TroyConversionParityTests.cs
  - TroyEmitterGapTests.cs
  - TroyFieldMapTests.cs
  - TroyForceFieldTests.cs
  - TroyOrientationAndDistortionTests.cs
  - TroyParityHarnessTests.cs
  - TroyPrimitiveTests.cs
  - TroyScalarPromotionTests.cs
  - TroyVocabularyTests.cs
  - UnnamedTextureTests.cs
  - UpdateFlowTests.cs
  - UvEditorViewModelTests.cs
  - VfxBillboardBasisTests.cs
  - VfxBlendTests.cs
  - VfxDrawOrderTests.cs
  - VfxFlagPolarityTests.cs
  - VfxPlaybackSimParityTests.cs
  - VfxPreviewCoverageTests.cs
  - VfxPreviewRigTests.cs
  - VfxSystemRoleTests.cs
  - ViewportIconTests.cs
  - ViewportPickRoundTripTests.cs
  - ViewportShortcutTests.cs
  - ViewportToolbarTests.cs
  - WadChunkLinkTexturePathTests.cs
  - WadPackDedupTests.cs
  - WadPathRecoveryTests.cs
  - WindowChromeTests.cs
  - WorkshopMeshShelfTests.cs
  - WorkshopUserLibraryTests.cs
  - WorldProjectedTerrainTests.cs
  - XamlBindingSyntaxTests.cs
- - README.md
  - reyengine_bridge.py
.gitignore
AGENTS.md
bgtex_debug.txt
Directory.Build.props
LICENSE
README.md
ReyEngine.slnx
run.bat

# Use via CDN

jsDelivr

jsDelivr serves any public GitHub repository as a CDN with zero setup. Pick a version and a file to get a ready-to-paste link and snippet.

Version

File

Link

Example

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

A modern map &amp; asset editor for League of Legends mods — think Unreal/Unity for LoL assets. 
 Built by <a href="https://github.com/TheKillerey">TheKillerey</a>.

<a href="https://github.com/TheKillerey/ReyEngine/releases"><img src="https://badgen.net/github/release/TheKillerey/ReyEngine?color=c22a44&label=release" alt="Latest release" /></a>
 <a href="LICENSE"><img src="https://badgen.net/github/license/TheKillerey/ReyEngine?color=c22a44" alt="License" /></a>

![ReyEngine — map editing](https://raw.githubusercontent.com/TheKillerey/ReyEngine/main/docs/screenshots/editor-main.webp)

<table>
 <tr>
 <td width="50%">
 <img src="docs/screenshots/model-preview-dominion.webp" alt="Model Preview — champion on the Dominion backdrop" /> 
 Model Preview — champions on the classic Dominion map, with in-game-accurate animations, VFX &amp; SFX
 </td>
 <td width="50%">
 <img src="docs/screenshots/particle-editor.png" alt="Particle Editor" /> 
 Particle Editor — live-edit VFX systems with in-viewport playback
 </td>
 </tr>
 <tr>
 <td width="50%">
 <img src="docs/screenshots/new-project-wizard.png" alt="New Project wizard" /> 
 New Project wizard — templates for skins, maps, VFX, audio and UI mods
 </td>
 <td width="50%">
 <img src="docs/screenshots/setup-wizard.png" alt="First-run setup wizard" /> 
 Setup wizard — hashes, audio decoder and preview map in a few clicks
 </td>
 </tr>
</table>

> **Status: beta.** Windows only. Expect rough edges — please report issues!

## What it does

**Projects**
- Unreal-style **New Project wizard**: pick a template (Champion Skin / Map / VFX / Audio / UI / Empty), choose your **LIVE or PBE** client (auto-detected), tick the WADs you want, pick which content categories to extract — get a ready-to-edit mod project (cslol-style folders + read-only Riot references).
- **Import .fantome**: convert any existing mod package into an editable project — mod name/author/thumbnail carry over, WADs unpack with resolved file names, and matching Riot WADs attach as references. Full round trip: *import → edit → Build Package → new .fantome*.
- Non-destructive by design: Riot files are never modified; edits become **project overrides** that build into a distributable `.wad.client` / `.fantome` package.
- **Automatic Riot patch rebasing**: when the installed client advances, project `.bin` edits are three-way merged onto Riot's new originals, backed up, validated, and rebuilt as WAD + `.fantome`. Conflicts and retained full-replacement assets are reported for review; the behavior can be disabled per project.
- **First-run setup wizard** gets a fresh install working in a few clicks: hashes, audio decoder, optional preview map (re-run any time via *Help ▸ Setup Wizard*).

**Maps**
- Load `.mapgeo` maps with baked lightmaps, terrain-blend & flowmap-water shaders, GrassTint (VertexDeform), display-correct decals.
- **Map Skin Switcher** safely forces a normal map (for example Map11 / Base_SRX) through another shipped environment (for example Milkshake). It routes the complete visual environment across registered slots and internal aliases while retaining their runtime identity, builds a compatibility materials container that preserves the server-addressed gameplay IDs which otherwise crash StartSpawn, and routes dedicated source music/ambience through the current skin's audio identity. Both generated bins, dependencies and asset references are validated before saving; paid TFT arenas / Map22 are intentionally excluded.
- Select / move / rotate / scale **map meshes, particles and sounds** with viewport gizmos — full undo, snapping, world/local space. Edits are saved by surgical byte patching (originals stay byte-exact).
- **Add new meshes to a map**: import `.obj` / `.scb` / `.sco`, place with the gizmo, assign a map material, save — appended straight into the mapgeo.
- **Bucket grids**: view the real 3D culling bake, and regenerate grids after editing geometry.
- **Dynamic lights**: load classic Riot `Light.dat` point lights, fit them to any map (scale/offset), full lighting panel (sun, sky, lightmap brightness).
- **Recolor Textures** adjusts map surfaces, placed mobs / animated props and baked lightmaps together, with presets and `.cube` colour grades always re-derived from Riot's originals.
- **Classic NVR maps**: the old-format Dominion / Crystal Scar loads with faithful four-blend ground shading — used as the Model Preview backdrop (separate ~66 MB [map asset pack](https://github.com/TheKillerey/ReyEngine/releases/tag/maps)).

**Model Preview**
- Champion viewer with animations, per-submesh visibility (game-accurate: skin-bin initial hide + per-clip show/hide events, with manual override), and model scale.
- **Plays like in-game**: animation clips trigger their VFX bone-attached and their SFX through the champion's real Wwise banks — frame-accurate, retriggered on loop.
- Preview champions **standing on the Dominion map**, lit by its original point lights — movable, rotatable, tunable.

**Assets**
- Content Browser with Explorer-grade file ops: rename, delete, move, drag & drop (in and out), open-with-text-editor, thumbnails, type filters, search.
- Texture/mesh/skeleton/animation preview, `.bin` structure editor, material editor with Riot shader awareness, hash resolving (CommunityDragon).
- **Particle editor**: live-edit VFX systems (colors, curves, textures) with in-viewport playback.
- **Audio**: browse Wwise banks, play events (vgmstream), replace `.wem` sounds, positional map ambience.

**Polish**
- Dark themes (Crimson / Kalista / Violet) switchable live, custom chrome on every window, auto-update check against GitHub releases.

## Getting started

1. Install [League of Legends](https://www.leagueoflegends.com) (LIVE and/or PBE).
2. Download the latest release from [Releases](https://github.com/TheKillerey/ReyEngine/releases): the `.msi` installs for the current user (no administrator rights) under `%LocalAppData%\Programs\ReyEngine` and can keep itself up to date; the `.zip` is the same build as a portable folder. Or build from source:
   ```
   dotnet build src/ReyEngine.App/ReyEngine.App.csproj -c Release
   ```
   Requires the .NET 10 SDK, Windows.
3. Launch — the **setup wizard** walks you through hashes, the audio decoder, and the optional preview map.
4. **File ▸ New Project…** (or **Import .fantome…**) and start modding.

## Built with

[LeagueToolkit](https://github.com/LeagueToolkit/LeagueToolkit) · [Avalonia UI](https://avaloniaui.net) · [Silk.NET](https://github.com/dotnet/Silk.NET) · [CommunityToolkit](https://github.com/CommunityToolkit/dotnet) · [NAudio](https://github.com/naudio/NAudio) · BCnEncoder.NET · SharpGLTF · Inter

Thanks to [CommunityDragon](https://communitydragon.org) (hashes), [vgmstream](https://github.com/vgmstream/vgmstream) (Wwise decoding), the [MapgeoAddon](https://github.com/TheKillerey/MapgeoAddon) research, and the League modding community.

## License

## Code signing policy

Free code signing for Windows binaries is provided by [SignPath.io](https://signpath.io), with a certificate issued by the [SignPath Foundation](https://signpath.org).

Every signed release is built automatically by GitHub Actions from this public repository; SignPath verifies that the signed binary originates from the tagged source before signing it. No binary is signed from a local machine.

- **Committers & reviewers:** [TheKillerey](https://github.com/TheKillerey)
- **Approvers:** [TheKillerey](https://github.com/TheKillerey)

## Privacy policy

ReyEngine does not transfer any personal data to networked systems. It makes a few outbound network requests, all initiated by the user or clearly disclosed:

- **Update check** — on startup (and via *Help ▸ About*), it queries the public GitHub Releases API for this repository to see whether a newer version exists. Only the request itself is sent; no personal or usage data is transmitted. A new release is shown with its changelog; *Settings ▸ General ▸ Updates* chooses between installing it automatically, asking first, or only opening the download page. The MSI takes the same choice on its options page or as `msiexec /i ReyEngine-vX.Y.Z-win-x64.msi AUTOUPDATE=0`.
- **Hash sync** — when you choose to sync hash tables, it downloads public hash lists from [CommunityDragon](https://communitydragon.org).
- **Project patch update** — for projects with automatic patch rebasing enabled, opening the project checks CommunityDragon's public patch list and downloads the old Riot `.bin` originals needed for a local three-way merge. No project files are uploaded.
- **Setup downloads** — the setup wizard downloads [vgmstream](https://github.com/vgmstream/vgmstream) and the optional [map asset pack](https://github.com/TheKillerey/ReyEngine/releases/tag/maps) from GitHub when you click their buttons.

ReyEngine only reads your local League of Legends installation and writes to the project/output folders you select. Uninstall an MSI install from Windows' *Installed apps*, or delete the extracted zip folder.

## Legal

ReyEngine was created under Riot Games' ["Legal Jibber Jabber"](https://www.riotgames.com/en/legal) policy using assets owned by Riot Games. Riot Games does not endorse or sponsor this project.

ReyEngine

Owner Repos

File Explorer

# Use via CDN

Was this content helpful?

Recent Feedback

ReyEngine

Owner Repos

File Explorer

# Use via CDN

Was this content helpful?

Recent Feedback

Download README