https://github.com/calinou/game-maps-obj
Open source game maps as OBJ files (useful for testing 3D engines)
https://github.com/calinou/game-maps-obj
obj test-meshes
Last synced: about 1 year ago
JSON representation
Open source game maps as OBJ files (useful for testing 3D engines)
- Host: GitHub
- URL: https://github.com/calinou/game-maps-obj
- Owner: Calinou
- Created: 2020-05-17T14:10:36.000Z (almost 6 years ago)
- Default Branch: master
- Last Pushed: 2023-10-21T11:15:21.000Z (over 2 years ago)
- Last Synced: 2024-10-18T14:48:20.129Z (over 1 year ago)
- Topics: obj, test-meshes
- Language: Python
- Homepage:
- Size: 48 MB
- Stars: 97
- Watchers: 9
- Forks: 8
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Game maps as OBJ meshes
This repository contains various OBJ files exported from
[Sauerbraten](https://sauerbraten.org), [Red Eclipse](https://www.redeclipse.net)
and [Tesseract](https://tesseract.gg). These maps were exported using the
`/writeobj ` command after loading the map in the game.
Looking for the cmvalley map exported as an OBJ file? Head to the
[Releases](https://github.com/Calinou/game-maps-obj/releases/latest) tab.
## Games
Maps were exported from the following games:
- **Red Eclipse** (commit [`ecfe18c51`](https://github.com/redeclipse/maps/commit/ecfe18c51ffa192ca127920170ea7f33b99c2dd2))
- **Sauerbraten** (2020 edition)
- **Tesseract** (SVN revision 2343)
## Recommended maps
Here are some hand-picked recommendations if you'd like to try out some maps:
| Name | Game | Vertex/triangle count | Good for | License |
|----------------:|:------------|:--------------------------------------|:-----------------------------------------------------------------|:----------------|
| cmvalley¹ | Sauerbraten | :red_square: 1112k verts, 2080k tris | Testing renderers in a large scale/open world map | CC BY 4.0 |
| core_transfer | Sauerbraten | :green_square: 45k verts, 76k tris | Testing global illumination and fog | CC BY-NC-SA 2.5 |
| eternal_valley | Sauerbraten | :green_square: 55k verts, 98k tris | Testing global illumination and its resistance to leaks | CC BY-NC-SA 3.0 |
| earthstation | Sauerbraten | :red_square: 440k verts, 188k tris | Testing renderers in a space station with interior and exterior | CC BY-NC-SA 4.0 |
| fc4 | Sauerbraten | :green_square: 44k verts, 80k tris | Testing renderers over a fairly large area (with inland terrain) | CC BY-NC-SA 3.0 |
| fc5 | Sauerbraten | :yellow_square: 103k verts, 189k tris | Testing renderers over a fairly large area (mostly buildings) | CC BY-NC-SA 3.0 |
| gorge | Sauerbraten | :green_square: 171k verts, 92k tris | Testing renderers in a mixed indoor/outdoor cave map | CC BY-NC-SA 4.0 |
| hidden | Sauerbraten | :yellow_square: 105k verts, 190k tris | Testing renderers over a fairly large area (mostly buildings) | CC BY-NC-SA 3.0 |
| k_rpg1 | Sauerbraten | :yellow_square: 136k verts, 261k tris | Testing renderers in a large scale/open world map | CC BY-NC-SA 2.5 |
| octavus | Red Eclipse | :green_square: 52k verts, 86k tris | Testing renderers over a fairly large area (with smooth terrain) | CC BY-SA 3.0 |
| pandora | Sauerbraten | :green_square: 36k verts, 61k tris | Testing lighting in a fully indoor level | CC BY 4.0 |
| reflection | Tesseract | :green_square: 68k verts, 116k tris | Testing global illumination and fog (indoors with sunlight) | CC BY-SA 3.0 |
| skrsp1 | Sauerbraten | :green_square: 59k verts, 103k tris | Testing renderers over a fairly large area (with terrain) | CC BY-NC-SA 3.0 |
| steelribs | Tesseract | :green_square: 27k verts, 46k tris | Testing renderers with a floating hard-surface map | CC BY-SA 3.0 |
| tectonic | Sauerbraten | :green_square: 47k verts, 87k tris | Testing renderers with an island-style map (buildings + terrain) | CC BY 4.0 |
| ubik | Red Eclipse | :yellow_square: 87k verts, 166k tris | Testing renderers with a floating futuristic urban area | CC BY-SA 3.0 |
| warlock | Sauerbraten | :yellow_square: 191k verts, 108k tris | Testing renderers with a symmetrical outdoor castle map | CC BY-SA 4.0 |
¹: cmvalley can be downloaded from the [Releases](https://github.com/Calinou/game-maps-obj/releases/latest) tab.
## Using textures
If you wish textures to be available for use in other engines, you can extract
them from a Sauerbraten, Red Eclipse or Tesseract installation folder.
To avoid having to copy the entire installation folder (and suffering from long
import times as a result), install [Python](https://www.python.org/) and run
`collect_textures.py` with the following arguments:
```bash
python collect_textures.py path/to/file.mtl --input path/to/game/installation/folder --output path/to/folder
```
This will copy textures referenced within a MTL file to be used in another
engine. Make sure to point `--output` to the location where the OBJ/MTL files
are stored, as texture paths are relative to the MTL file's location.
## Caveats
- Maps are exported at a larger scale than you probably want.
This may cause large maps not to appear at all once imported due to
view frustum culling. To solve this, tell the engine to import the OBJ mesh
at a lower scale if possible. Otherwise, you can scale the OBJ mesh by a
factor of about `0.05`. (Scaling afterwards may reduce mesh precision, which is why scaling
at import-time should be preferred.)
- Due to how maps are designed in Cube 2 engine games, their topology may be
inefficient or otherwise unusual. This could lead to issues when generating
collision meshes automatically.
- Maps don't contain lights, mapmodels (detail models such as trees, barrels, …)
and materials (such as water, lava and glass). You will have to readd those
manually if desired.
## License
See `.txt` files associated with each map for the license.
All maps in the `redeclipse/` and `tesseract/` folders are under free culture
Creative Commons licenses (with commercial use and modification allowed).
In those folders, CC BY-SA is the strictest license used, although some maps
are under CC BY or CC0 instead.
> **Warning**
>
> Some maps in the `sauerbraten/` folder use Creative Commons licenses that
> disallow commercial use. Still, modification is allowed as maps that use a
> no-derivatives license were excluded from this set.