Skip to content

jakjus/jjrs

Repository files navigation

JJRS - Jakjus Real Soccer

License: MIT

Haxball Room Script for JJRS (Jakjus Real Soccer)

Draft System Preview

🚀 Discord

Features

  • Real Soccer Map and Draft Map
  • Outs, Goal Kicks, Corners
  • Fouls, Yellow and Red cards
  • Free Kicks, Penalties
  • Offsides
  • Natural kicks (slight rotation)
  • Natural outs and ball passes
  • Slide, Sprint
  • Teamplay Bonus
  • ELO System (SQLite database)
  • Draft System - top ranked players choose their team
  • Fully automatic

Prerequisites

  • NPM
  • NodeJS

Install

git clone git@github.com:jakjus/jjrs.git
cd jjrs/
npm install

Usage

Rename config.example.ts with config.ts. Insert token from https://haxball.com/headlesstoken into config.ts.

// config.ts

export default {
  roomName: `🌕   JJRS v0.1.0 by jakjus`,
  public: true,
  maxPlayers: 30,
  token: `YOUR_TOKEN_HERE`,
};

Run Server:

npm start

How to play

When you pass within team, ball kicks get stronger, until enemy touches it. It promotes team play. Hold and release KICK to activate superpower. Release on correct emoji to activate chosen power.

  • 👟 Slide: Slide in chosen direction. If you touch an enemy player, he will be fouled.
  • 💨 Sprint: Sprint in chosen direction
  • 🩹 Call Foul: If you are fouled, you have short time to call foul by holding KICK. If you do not use it, the game goes on (privilege of benefit).

Commands

[NOTE] It is not intended do pause/stop/start games manually, as well as change maps (also through using commands). Most of the time it works, but the script was not designed to handle manual actions.

  • !login your_admin_pass - login as admin. It allows you to use !rs and !draft
  • !draft - start draft. Stopping it before end result may result in a in server crash.
  • !rs - change map to Jakjus Real Soccer

Settings

Some script settings can be changed in src/settings.ts. Also, if you change RS map physics, you should update settings values in src/settings.ts.

Author

👤 Jakub Juszko

🤝 Contributing

This package is not published on NPM, because the script is self-contained and I do not expect anyone to plug it into a bigger script.

Contributions, issues and feature requests are welcome!
Feel free to check issues page.

Show your support

Give a ⭐️ if this project helped you!

📝 License

Copyright © 2024 Jakub Juszko.
This project is MIT licensed.


Releases

No releases published

Packages

No packages published