The Crossplay Project Source

This repository contains the source code for both the Minecraft and Roblox sides of the Crossplay Project.

Minecraft Side

Overview

The Minecraft side features the CrossplayPackage plugin; a package containing 5 of our smaller plugins.

The plugin hosts a Spark webserver on port 4567 (configurable).

Plugin Compilation from Source

To compile the plugin from source, follow these steps:

1. Install IntelliJ IDEA: If you haven't already, download and install IntelliJ IDEA.

2. Download the CrossplayPackage Directory: Obtain the source code directory for CrossplayPackage.

3. Open as IntelliJ Project:

   • Launch IntelliJ IDEA.
   • Open the CrossplayPackage directory as an IntelliJ project.

4. Build the Plugin:

   • Go to Build > Build Artifacts in the IntelliJ menu.
   • Select the action Build.

5. Locate the Compiled JAR:

   • After the build process completes, the compiled .jar file will be located in the out/artifacts folder within your IntelliJ project directory.

Endpoints

/blocks

• Description: Retrieves all blocks in specified chunk(s) or area.
• Method: GET
• Arguments: chunkX and chunkZ OR cord1 and cord2.
• Response: JSON array of blocks.

Example request for a single chunk:

curl http://<server-ip>:4567/blocks?chunkX=0&chunkZ=0

Example request for multiple chunks (3x3 grid with center at 0,0):

curl http://<server-ip>:4567/blocks?chunkX=-1,1&chunkZ=-1,1

Example request for an exact area:

curl http://<server-ip>:4567/blocks?cord1=15,0,15&cord2=-15,25,-15

Example Response:

[
    {"t":"OAK_LOG","x":7,"y":0,"z":2,"s":"axis\u003dy"},
    {"t":"GRASS_BLOCK","x":7,"y":-1,"z":3,"s":"snowy\u003dfalse","b":"PLAINS"},
    {"t":"STONE","x": 0,"y": 0,"z": 0}
]

/players

• Description: Retrieves information about players currently on the server.
• Method: GET
• Response: JSON array of player information.

Example request:

curl http://<server-ip>:4567/players

Example Response:

[
    {"uuid":"<UUID>","mainItem":"AIR","offItem":"AIR","x":8,"y":0,"z":1,"yaw":79,"pitch":18,"crouch":false}
]

/mobs

• Description: Retrieves information about mobs currently present in the server.
• Method: GET
• Response: JSON array of mob information.

Example Request:

curl http://<server-ip>:4567/mobs

Example Response:

[
    {"uuid":"<UUID>","x":6.5,"y":0.0,"z":1.5,"yaw":-90.0,"pitch":0.0,"mobType":"WANDERING_TRADER"}
]

/world

• Description: Retrieves information about the overworld.
• Method: GET
• Response: JSON object containing overworld data such as time and weather conditions.

Example Request:

curl http://<server-ip>:4567/world

Example Response:

{"time":6000,"thundering":false,"raining":false}

/post

• Description: Performs various actions on the server. Supports BUILD, BREAK, TOGGLE, and EDIT actions.
• Method: POST
• Actions:
  • BUILD: Requires x, y, z, material, direction, and action.
  • BREAK: Requires x, y, z, and action.
  • TOGGLE: Requires x, y, z, and action.
  • EDIT: Requires x, y, z, line, text, and action.

Example Request:

curl -X POST http://<server-ip>:4567/post -d 'action=BUILD&x=0&y=0&z=0&material=STONE&direction=NORTH'

Example Data:

• For BUILD:

  {
      "x": 0,
      "y": 0,
      "z": 0,
      "material": "STONE",
      "direction": "NORTH",
      "action": "BUILD"
  }
  

• For BREAK:

  {
      "x": 0,
      "y": 0,
      "z": 0,
      "action": "BREAK"
  }
  

• For TOGGLE:

  {
      "x": 0,
      "y": 0,
      "z": 0,
      "action": "TOGGLE"
  }
  

• For EDIT:

  {
      "x": 0,
      "y": 0,
      "z": 0,
      "line": 2, (ranging from 0 to 3)
      "text": "Hello, World",
      "action": "EDIT"
  }
  

/chat

• Description: Accepts and provides chat messages from and to Roblox.
• Method: GET, POST

Example response:

[{"sender":"The_Atmerek","message":"Hi"},{"sender":"The_Atmerek","message":"Hello"}]

Example payload:

{
    "player": "wwwdr666",
    "color": "#FFFFFF",
    "message": "Hewoo~"
}

/npc

• Description: Accepts data to spawn an NPC in-game.
• Method: POST

Example payload:

{
    "x": 0,
    "y": 0,
    "z": 0,
    "yaw": 90,
    "pitch": 45,
    "disconnect": true (optional)
}

Roblox Side

Overview

The Roblox side provides a framework to help you start creating your own code. It includes several scripts and models to manage block data and interactions within Roblox.

Roblox files and scripts:

Workspace

• Blocks
  A folder to store block models.
• Players
  A folder to store player models.

ServerScriptService

• BlockHandler.lua
  Contains the system for fetching chunk data and cloning models into the workspace.

• BlockBreakHandler.lua
  Manages POST requests for block breaking on the server side.

• BlockPlaceHandler.lua
  Manages POST requests for block placing on the server side.

• PlayerHandler.lua
  Manages the Minecraft players in Roblox.

• NPCHandler.lua
  Manages the Roblox players in Minecraft.

• TimeHandler.lua
  Contains a script to convert Minecraft time values and apply them.

• ChatHandler.lua
  Manages in and out messages.

• ImageAuth.lua
  An authentication script for the remote_img library.

ReplicatedStorage

• models.rbxm
  Contains a folder with a few block models.

• IP.rbxm
  Contains a text value with the server IP.

• BlockStateManager.lua
  An additional module for applying rotation to models.

• CurrentBlocks.lua
  An additional module for synchronizing blocks across scripts.

• Chat.rbxm
  A RemoteEvent for the chat messages.

• loadPlayerSkin.rbxm
  A RemoteEvent for applying player skins.

• remote_img.rbxm
  A module library for managing EditableImage.

• Player.rbxm
  A model of the Minecraft player.

StarterPlayer

• StarterPlayerScripts:
  • BreakBlockScript.lua
    Contains the local side of the block breaking system.
  • PlaceBlockScript.lua
    Contains the local side of the block placing system.
  • Chat.lua
    Contains the local side of the chat system.
  • SkinLoader.lua
    Contains the local side of the skin system.

StarterGui

• ModifyMode.rbxm
  Contains two GUI buttons for the action scripts.

Our API

We provide an API to resolve Minecraft player's usernames and skins by their UUIDs. The API supports both Java and Bedrock (floodgate) UUIDs.

Get Username by UUID

Endpoint: /api/uuid/:uuid

• Method: GET
• Description: Retrieves the username associated with the provided UUID.
• Parameters:
  • uuid (string): The UUID of the Minecraft player. Supports both Java and Bedrock UUIDs.

Example Request:

curl https://crossplayproject.xyz/api/uuid/92270a4f-f954-4087-a932-e8d0e5deb2bd

Example Response:

{
    "username":"The_Atmerek"
}

Get Skin by UUID

Endpoint: /api/uuid/:uuid/skin

• Method: GET
• Description: Retrieves the skin associated with the provided UUID.
• Parameters:
  • uuid (string): The UUID of the Minecraft player. Supports both Java and Bedrock UUIDs.

Example Request:

curl https://crossplayproject.xyz/api/uuid/92270a4f-f954-4087-a932-e8d0e5deb2bd/skin

Response: Returns the skin image in PNG format.

Selfhosting

To selfhost the project, you will need a host that supports custom HTTP ports and plugins (if it can run Dynmap, it can probably run this), or a plain VPS server.

Minecraft Side

Hosting on a Linux VPS server:

1. Install Java: Ensure Java 21 is installed by running java --version. If not installed, run sudo apt install openjdk-21-jdk.

2. Prepare Directory:

   • Create a new directory for your Minecraft server:

     mkdir <folder-name>
     cd <folder-name>
     

3. Download Server Software:

   • Download a Paper or Spigot server .jar file:

     wget <url>
     

4. Run the Server:

   • Start the server with allocated memory:

     java -Xmx<max-ram>M -Xms<min-ram>M -jar <jar-name>.jar
     

5. Agree to EULA:

   • Edit eula.txt to accept the EULA:

     nano eula.txt
     

   • Change false to true, save with CTRL+O, and exit with CTRL+X.

6. Configure Server:

   • Modify server.properties:

     nano server.properties
     

   • Add {"layers":[{"block":"minecraft:air","height":63},{"block":"minecraft:grass_block","height":1}]} to the generator-settings field.
   • Set level-type to minecraft:flat.

7. Install Plugins:

   • Navigate to the plugins directory (create it if necessary) and download the required plugins:
     • CrossplayPackage.jar
     • Citizens-2.0.35.jar

8. Start Server:

   • Run the server again and allow it to generate necessary files.

Note: Additional hosting options may be provided in the future.

Roblox Side

1. Upload Game:

   • Download the Roblox game or create your own from the source, then upload it to Roblox.

2. Configure IP:

   • Set the IP and port of your Minecraft server's HTTP endpoint in ReplicatedStorage, example "server-ip:CrossplayPackage port".

3. Enable HTTP Requests:

   • Go to game settings on Roblox and enable HTTP reque