Jump to content

Resources/Collision Pointcloud

From HEModdingWiki
Revision as of 19:47, 7 January 2025 by Ashrindy (talk | contribs)
Collision Pointcloud
Resource TypePhysics
File Extension.pccol
Used In Games
Container FormatBINA
Editing Tools
Reverse Engineering StatusDone

Collision Pointcloud is a fileformat used since Sonic Frontiers, that's used to place collision models (.btmesh) in a stage using a collection of instances with resource names.

File Format

This is one of the many BINA file formats, meaning it's very easily memory-mappable.

The structure of this format is very simple, it contains a signature "CPIC", the version "2" (no instances have been found with the version 1) and the list of instances itself.

The structure of an instance is

  • Instance name, to easily differentiate between different instance.
  • Resource Name, to set the Bullet Mesh file name of the instance.
  • Position, straight forward.
  • Rotation, straight forward.
  • Scale, straight forward.
  • Unknown value.

Technical Info

Since this is a BINA file format, it's very easy to show this type in a struct/memory map it.

struct Instance{
    const char* instanceName;
    const char* resourceName;
    csl::math::Position position;
    csl::math::Position rotation;
    int unk0;
    csl::math::Position Scale;
    long unk1;
};

struct PointcloudLight{
    char signature[4];
    uint version;
    int instanceCount;
    Instance* instances;
};