rosaserver / rosaserver

A server scripting API for Sub Rosa.

A linux server scripting API for Sub Rosa.

⚠ Early in development, APIs can change at any time.

RosaServer uses LuaJIT/moonjit; this means there's no hit to performance while being able to create anything from moderation tools to complex custom games with easy-to-write version agnostic code.

Getting Started

Installing

• Build the library or download the latest Release.
• Your directory should contain libluajit.so, librosaserver.so, subrosadedicated.x64, and the data folder (the last two can be found with your game install).
  • You will also need the rosaserversatellite binary if you plan to use the ChildProcess API. Make sure it has execute permissions.
• There's a 99% chance you'll also want to use RosaServerCore.

Running

LD_PRELOAD="$(pwd)/libluajit.so $(pwd)/librosaserver.so" ./subrosadedicated.x64

The server will start as normal and main/init.lua will be executed.

Documentation

For complete reference on using the Lua API, go to the wiki.

Building

Make sure all submodules are cloned, and run ./build.sh

Required Packages

• build-essential on Debian/Ubuntu
• cmake
• libssl-dev
• libsqlite3-dev
• libopus-dev

Here's a basic script I use to copy the required files after they're compiled. For example, ./build.sh && ./postbuild.sh

#!/bin/bash

DEST=../RosaServerCore/

cp ./moonjit/src/libluajit.so "$DEST"
cp ./release/RosaServer/librosaserver.so "$DEST"
cp ./release/RosaServerSatellite/rosaserversatellite "$DEST"

---

Thanks to these open source libraries:

• moonjit
• Sol3
• SubHook
• cpp-httplib
• stb

rosaserver's Issues

Special characters such as 'ığüçöş' is not handled properly

Describe the bug
When typing a special unicode charecter such as 'ğ' it displays a unknown character that needs to be deleted twice and such.

To Reproduce
Steps to reproduce the behavior:

1. ./start
2. Type a special character that is not handled properly.
3. See error

Expected behavior
I would expect it to print that character, but something else prints.

Screenshots
If applicable, add screenshots to help explain your problem.

Additional context
Unicode handling?

item.isGun returning nil

Describe the bug
When trying to check if a item is a gun or not in ItemLink hook it's always returning nil. Buying a gun or /arm-ing.

To Reproduce
Steps to reproduce the behavior:

1. Hook ItemLink.
2. Use this code:
   if item then if parentHuman then mode:print(item.isGun) end end
3. Go in-game and try to buy a gun or /arm.
4. See error.

Expected behavior
For that value to be either true or false.

Screenshots

Additional context
I'm guessing that this is a property that I need to set.

Add shortcuts to the terminal to easily manipulate a line

Home, End, Ctrl-Left, Ctrl-Right and so on.

TCPServer should return nil on 'Socket already in use'

Because there is no way to check if a socket is in use without this or in Lua, you can't find a port until its available.

When a line wraps around and then the terminal expands, line gets messed up

Describe the bug
If you type a line so long that wraps around the terminal and then expand the terminal, the line merges incorrectly.

To Reproduce
Steps to reproduce the behavior:

1. Launch.
2. Type a long line and make it wrap around the terminal.
3. Expand or make the font size smaller to make the line one line.
4. See error

Expected behavior
Line should be correct instead of gibberish.

Screenshots
If applicable, add screenshots to help explain your problem.

Additional context
Can look for terminal expand events and font size change events and then rewrite the line.

Segmentation fault in VehicleDestroy hook via printing vehicle parameter

Describe the bug
When printing the vehicle/veh parameter in the VehicleDelete hook, a segmentation fault occurs.

To Reproduce
Steps to reproduce the behavior:

1. Create a VehicleDelete hook.
2. Do print(veh).
3. Go 16 units away from a TrafficCar to make it despawn.
4. See error.

Expected behavior
Expected for it to print Vehicle (0).

Screenshots
If applicable, add screenshots to help explain your problem.

Additional context
Stack traceback:
#0 librosaserver.so(+0x3c67e1) [0x7fb3f2eac7e1]
#1 /usr/lib/libc.so.6(+0x3cda0) [0x7fb3f27cfda0]
#2 librosaserver.so(_ZN3Lua5printEN3sol13variadic_argsENS0_10this_stateE+0x236) [0x7fb3f2df14b6]
#3 librosaserver.so(_ZN3sol15function_detail21upvalue_free_functionIRFvNS_13variadic_argsENS_10this_stateEELb0EE4callEP9lua_State+0x4a) [0x7fb3f2f2210a]
#4 librosaserver.so(+0x3c434a) [0x7fb3f2eaa34a]
#5 libluajit.so(+0xa78a) [0x7fb3f34fa78a]
#6 libluajit.so(lua_pcall+0x59) [0x7fb3f350d8c9]
#7 librosaserver.so(+0x372bb3) [0x7fb3f2e58bb3]
#8 librosaserver.so(_ZN5Hooks13deleteVehicleEi+0x105) [0x7fb3f2e68025]
#9 ./subrosadedicated.x64(+0x5d750) [0x563c00c5d750]

createevent_updateplayer_finance hook crash

Hooking createevent_updateplayer_finance results in a segfault in a few cases (when a round resets, round death tax apparently). I have no idea why. It'll be disabled for now.

RosaServer/RosaServer/hooks.cpp

Line 1095 in 29fb99c

void h_createevent_updateplayer_finance(int id)

Add ItemDelete and PostItemDelete to the Wiki

Tried to fork it and replacing the wiki but GitHub didn't detect any changes.