explaingit

imuarte/kgmexporter

★ 18C#Audience · generalComplexity · 2/5Setup · easy

TLDR

A preservation tool for KoGaMa map files: upload .kgmap files to the Internet Archive or convert them to .obj 3D mesh format viewable in Blender, saving game worlds from a shut-down platform.

Mindmap

mindmap
  root((repo))
    Upload
      Single kgmap file
      Zip or RAR batch
      Folder batch
      Internet Archive
    Convert
      kgmap to obj
      Material file
      Texture atlas
      Blender ready
    Formats
      kgmap input
      obj output
      Legacy skip
    Browse
      GitHub Pages archive
      Preserved maps
    Interface
      Tab based UI
      File picker
Click or tap to explore — scroll the page freely

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Things people build with this

USE CASE 1

Upload your old KoGaMa .kgmap files to the Internet Archive so they are publicly preserved before they are lost forever.

USE CASE 2

Convert a KoGaMa map file into a standard .obj 3D mesh you can open and explore in Blender or any 3D software.

USE CASE 3

Browse the existing archive of already-preserved KoGaMa maps on the project's GitHub Pages site without running the tool.

USE CASE 4

Batch-upload a folder or zip of many .kgmap files to the Internet Archive in one go.

Tech stack

C#.NETOBJ formatInternet Archive

Getting it running

Difficulty · easy Time to first run · 30min

Tab-based UI with file picker, no complex configuration documented. Pick upload or convert tab, choose files, and run.

No license was mentioned in the explanation.

In plain English

KoGaMa was an online platform where people could build and share 3D game worlds. When the platform shut down, the maps people had created became inaccessible, and this tool was built to help preserve them. kgmexporter does two things. The first is uploading: you can take your saved .kgmap files, either as individual files or packed into a zip, rar, or folder, and send them to the Internet Archive so they are preserved publicly. Maps in an older legacy format are skipped automatically. The second function is conversion: the tool can take a .kgmap file and turn it into the standard .obj mesh format, along with a material file and a texture atlas, which you can open directly in Blender or other 3D software. This lets you view or reuse the geometry from a map outside of KoGaMa. A browseable archive of maps that have already been saved is hosted at the project's GitHub Pages site, so you can see what has been preserved without running the tool yourself. The README is short and the tool is focused on a specific preservation task rather than being a general-purpose converter. It has a simple tab-based interface: pick a tab for uploading or converting, choose your files, and run it. Beyond that, the repository does not document much else about configuration or technical requirements.

Copy-paste prompts

Prompt 1
I have a .kgmap file from KoGaMa. Walk me through using kgmexporter to convert it to an .obj file I can open in Blender.
Prompt 2
I want to upload a folder of .kgmap files to the Internet Archive using kgmexporter. What steps do I follow and what should I expect?
Prompt 3
Once I convert a .kgmap to .obj with kgmexporter, how do I import the obj file, material file, and texture atlas together into Blender so the map looks correct?
Prompt 4
What is a texture atlas and why does kgmexporter produce one alongside the .obj and material files when converting a KoGaMa map?
Open on GitHub → Explain another repo

← imuarte on gitmyhub — every repo by this author, as a profile.

Verify against the repo before relying on details.