A small collection of utilities for Croc.
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
 
 
 
 
Zane van Iperen afdec208c3
travis: add
2 days ago
cJSON @ cf97c6f066 libcroc: use external cJSON and fix include directories 2 months ago
croctool libcroc/map_unwad: use uint32_t instead of size_t 2 days ago
libcroc libcroc: include stdio.h in dir.h 1 week ago
resources add crocfile manifests 1 month ago
vsclib @ 8f2d2db4d0 vsclib: update 2 days ago
.gitignore add crocfile manifests 1 month ago
.gitmodules libcroc: use external cJSON and fix include directories 2 months ago
.travis.yml travis: add 2 days ago
CMakeLists.txt cmake: disable ENABLE_CUSTOM_COMPILER_FLAGS on cJSON 2 days ago
COPYING Truncate history before public release 4 months ago
Makefile add makefile for ci 4 months ago
README.md readme: update for croctool 1 week ago
convert.sh Truncate history before public release 4 months ago
default.nix nix: add files for ci 2 days ago
map.schema.json Truncate history before public release 4 months ago
release.nix nix: add files for ci 2 days ago

README.md

CrocUtils

A small collection of utilities for Croc.

For encoding/decoding of Argonaut ASF and BRP files, please see FFmpeg.

croctool

Usage

Usage: croctool map decompile <input-file.map> [<output-file.json|->]
       croctool map compile <input-file.json|-> <output-file.map>
       croctool map convert [--rebase [-]<000-899>] <input-file.map> <output-file.map>
       croctool map unwad <input-file.wad> <base-name>
       croctool crocfile dump <CROCFILE.DIR> [<output-file.json|->]
       croctool crocfile extract <CROCFILE.DIR> <CROCFILE.DAT|CROCFILE.1> [<outdir>]
       croctool mod burst2obj <input-file.mod> [<output-dir>]

map decompile

Convert any version of a Croc .MAP file into a JSON file for human editing.

map compile

Compile a JSON file into a version 21 Croc .MAP file.

map convert

Convert any version of a Croc .MAP file into version 21, readable by Croc DE.

  • --rebase will offset the door targets by the specified number.

map unwad

Split a PSX MAP%d.wad file into individual .MAP files.

  • Will NOT work with the MP%03d_%02d.WAD files.

crocfile dump

Dump a CROCFILE.DIR to JSON for human reading.

crocfile extract

Extract a CROCFILE.DIR and CROCFILE.{DAT,1} pair into the given directory. The directory must exist beforehand.

mod burst2obj

“Burst” a MOD file into separate Wavefront Alias OBJ meshes.

Material handling isn’t supported yet.

Notes

  • Odd padding in PSX maps

    • There was a batch of PSX maps I didn’t extract properly. Either I fopen()'d the file without b and Windows added padding, or the iso extraction too messed up.
    • There were sets of 0x0D 0x0A (or CRLF) randomly in there.
  • Extract the ISOs with https://github.com/cebix/psximager/

  • All 0.12 beta maps convert fine and are either v12_old or v12_old_noambient.

  • The .MAP files SLUS-00593, SLPS-01055, and SLES-00593 are identical. They are either normal, or v12

  • There are differences between the PSX and PC maps. Don’t be alarmed if things look slightly different.

    $ maptool decompile resources/maps/map/slus00530/MP010_03.MAP  | jq .point_lights[0]
    {
      "position": [
        0.1999969482421875,
        -0.28570556640625,
        2.1999969482421875
      ],
      "colour": [
        255,
        3,
        3
      ],
      "fade_from": 1,
      "fade_to": 1.5
    }
    $ maptool decompile resources/maps/map/pc/MP010_03.MAP  | jq .point_lights[0]
    {
      "position": [
        0,
        -0.4571380615234375,
        2
      ],
      "colour": [
        255,
        83,
        3
      ],
      "fade_from": 1,
      "fade_to": 1.5
    }
    

License

Copyright © 2020 Zane van Iperen

This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License version 2, and only version 2 as published by the Free Software Foundation.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA

3rd-party Licenses

Project License License URL
cJSON MIT https://github.com/DaveGamble/cJSON/blob/master/LICENSE