Sign in Join

Live chat for Free Pascal, Lazarus, Delphi and every Pascal programmer.

Catalog · How the catalog works

Random project

minecraft-server-map

Minecraft Server Mapper is a application developed in Pascal which router multiple minecraft servers on the same server based on the provided IP.

View on GitHub

Anyone may press Interesting, signed in or not. It helps others find this project.

Member rating

No ratings yet.

Sign in to rate this project.

README

Minecraft-Server-Map

Minecraft Server Mapper is a application developed in Pascal which router multiple minecraft servers on the same server based on the provided server adress.

This app allows you to host multiple minecraft servers on the same device and It will act as a proxy between the servers and the clients.

This functions by capturing the handshake of the client, and than comparing a list of all avalabile servers.

Latest up to date version

This version of the software was written in Lazarus, but in the meantime, I created a new version on Embaracadero Delphi 12 with more features, and which is more up to date. This version will no longer get updates. The new version is here:

https://github.com/Codrax/minecraft-server-mapper/edit/main/README.md

Dependencies

The app works as the single file executable, but for update checking functionality, the folder shared-lib is required in the same location as the executable.

Setting up

  1. Download the latest release
  2. Run the executable with the --create parameter to automatically create the configuration files
  3. Edit config.json and servers.json with your prefered settings
  4. Start the application

Configuration files

Configuration - config.json

Property Description Default
listen-port The port that the server will listen to. 25565
check-update Check for updates on app startup. true
file-monitor-delay The time in milliseconds to wait before checking if any changes were made to the configuration files. 0 to disable 3000
allow-default-mapping Redirect all connections that do not map to any of the servers to default-mapping false
default-mapping The default mapping Type: Mapping info

Servers - servers.json

This is an JSON array of Mapping info. The mapping info is as follows

Property Description
address The address to match in order to redirect to this server. Ex: play.site.com
host The network address to reditect data to. Ex: localhost or 192.168.1.101
port The port of the host that packets will go to. Note: DO NOT set to be the same as the listener port, that will cause recursion

Image of console output

image

Compiling

To compile this application, just install the Lazarus IDE version 2.2.6 together with Indy Internet Direct 10. The shared-lib executables need libssl, which you will need to find an compile with make. They should be avalabile here. Or you can use the pre-compiled version I have included.

Function

This application, uses a modified TIdMappedPortTCP from Indy, which captures the first handshake the client sends to the server, afterwhich, the Outbound connections is either established or discarded If there is a valid match for the adress. image

Examples

The config.json file

pascal
{
  "listen-port" : 25565,
  "check-update" : true,
  "file-monitor-delay" : 3000,
  "allow-default-mapping" : false,
  "default-mapping" : {
    "host" : "server-adress",
    "port" : 25565
  }
}

The servers.json file

pascal
[
  {
    "address" : "game.play.site.com",
    "host" : "localhost",
    "port" : 25570
  },
  {
    "address" : "game2.play.site.com",
    "host" : "192.168.1.104",
    "port" : 25571
  },
  {
    "address" : "192.168.1.107",
    "host" : "localhost",
    "port" : 25570
  }
]

Great resources

Here are some great resources that I used in this project