ChroMapper United Mapping (C.U.M.) allows mapping collaboration to occur in real-time. Mappers can host a session via the central server (called ChroMapTogether), or via direct IP/port connections. C.U.M. was introduced to the Stable branch in ChroMapper 0.8.523.

<need image>

Hosting a Session

You can start a C.U.M. session by pressing the Host Session button while editing a map.

<need image>

By default, the session will be hosted and managed by the ChroMapTogether server. You will be given a short room code to share with friends, and they will be able to connect without any need of port forwarding.

If you wish to directly host your C.U.M. session, simply click Use Direct Connection. You will need to forward whatever port is used for the session, and friends will have to connect via your public IP and assigned port.

Joining a Session

Friends can join a C.U.M. session by clicking on the United Mapping button in the song list.

<need image>

If you hosted the session through ChroMapTogether, they can simply input the given room code and directly join your session. However, if you are directly hosting your session, they will need to click Use Direct Connection and input your public IP/port.

Mapper Customization

This is a sub-menu available when hosting or joining a C.U.M. session.

<need image>

Display Name

This is simply your name, visible to other mappers in the C.U.M. session. Other players will see your display name above your camera, and above your grid cursor.

Grid Color

This is the color of your grid cursor and mapper indicator on the timeline. By default, it is randomized.

ChroMapTogether Server URL

This points to the ChroMapTogether server which is used to host/join C.U.M. sessions through room codes and no port forwarding. The default URL should almost always be used. However, if someone is interested in hosting their own ChroMapTogether server for private C.U.M. sessions with room codes, the source code is available here.