Fijxu
/
BattleBit-Community-Server-API
mirror of https://github.com/MrOkiDoki/BattleBit-Community-Server-API.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

Merge branch 'main' into lifesteal

This commit is contained in:
DasIschBims 2023-08-17 23:16:32 +02:00 committed by GitHub
parent 51941ee3cb 346290faec
commit 5fd00d6d98
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
19 changed files with 772 additions and 323 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

27
.github/ISSUE_TEMPLATE/bug_report.md vendored Normal file
View File

@ -0,0 +1,27 @@
---
name: Bug report
about: Create a report to help us improve
title: "[Bug]"
labels: bug
assignees: ''
---
**Describe the bug**
A clear and concise description of what the bug is.
**To Reproduce**
Steps to reproduce the behavior:
1. Go to '...'
2. Click on '....'
3. Scroll down to '....'
4. See error
**Expected behavior**
A clear and concise description of what you expected to happen.
**Screenshots**
If applicable, add screenshots to help explain your problem.
**Additional context**
Add any other context about the problem here.

20
.github/ISSUE_TEMPLATE/feature_request.md vendored Normal file
View File

@ -0,0 +1,20 @@
---
name: Feature request
about: Suggest an idea for this project
title: "[Feature Request]"
labels: enhancement
assignees: ''
---
**Is your feature request related to a problem? Please describe.**
A clear and concise description of what the problem is. Ex. I'm always frustrated when [...]
**Describe the solution you'd like**
A clear and concise description of what you want to happen.
**Describe alternatives you've considered**
A clear and concise description of any alternative solutions or features you've considered.
**Additional context**
Add any other context or screenshots about the feature request here.

26
.github/workflows/dotnet.yml vendored Normal file
View File

@ -0,0 +1,26 @@
# This workflow will build a .NET project
# For more information see: https://docs.github.com/en/actions/automating-builds-and-tests/building-and-testing-net
name: .NET build
on:
push:
branches: [ "main" ]
pull_request:
branches: [ "main" ]
jobs:
build:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v3
- name: Setup .NET
uses: actions/setup-dotnet@v3
with:
dotnet-version: 6.0.x
- name: Restore dependencies
run: dotnet restore
- name: Build
run: dotnet build --no-restore

2
BattleBitAPI/Common/Arguments/OnPlayerKillArguments.cs
View File

@ -1,4 +1,4 @@
using System.Numerics;
using System.Numerics;
using BattleBitAPI.Server;
namespace BattleBitAPI.Common

2
BattleBitAPI/Common/Conts.cs
View File

@ -28,6 +28,8 @@
public const int MinServerNameLength = 5;
public const int MaxServerNameLength = 400;
public const int MaxTokenSize = 512;
public const int MinGamemodeNameLength = 2;
public const int MaxGamemodeNameLength = 12;

4
BattleBitAPI/Common/Data/PlayerLoadout.cs
View File

@ -282,7 +282,7 @@
case AttachmentType.Barrel:
return this.Barrel == attachment;
case AttachmentType.UnderRail:
return this.Barrel == attachment;
return this.UnderRail == attachment;
case AttachmentType.SideRail:
return this.SideRail == attachment;
case AttachmentType.Bolt:
@ -307,7 +307,7 @@
this.Barrel = attachment;
break;
case AttachmentType.UnderRail:
this.Barrel = attachment;
this.UnderRail = attachment;
break;
case AttachmentType.SideRail:
this.SideRail = attachment;

1
BattleBitAPI/Networking/NetworkCommuncation.cs
View File

@ -15,6 +15,7 @@
SetNewRoundState = 15,
SetPlayerWeapon = 16,
SetPlayerGadget = 17,
SetPlayerModifications = 18,
PlayerConnected = 50,
PlayerDisconnected = 51,

211
BattleBitAPI/Server/GameServer.cs
View File

@ -101,6 +101,35 @@ namespace BattleBitAPI.Server
}
}
//Gather all changes.
this.mInternal.mChangedModifications.Clear();
lock (this.mInternal.Players)
{
foreach (var steamid in this.mInternal.Players.Keys)
{
var @internal = this.mInternal.mGetInternals(steamid);
if (@internal._Modifications.IsDirtyFlag)
this.mInternal.mChangedModifications.Enqueue((steamid, @internal._Modifications));
}
}
//Send all changes.
while (this.mInternal.mChangedModifications.Count > 0)
{
(ulong steamID, PlayerModifications<TPlayer>.mPlayerModifications modifications) item = this.mInternal.mChangedModifications.Dequeue();
item.modifications.IsDirtyFlag = false;
//Send new settings
using (var pck = Common.Serialization.Stream.Get())
{
pck.Write((byte)NetworkCommuncation.SetPlayerModifications);
pck.Write(item.steamID);
item.modifications.Write(pck);
WriteToSocket(pck);
}
}
try
{
//Are we still connected on socket level?
@ -315,7 +344,7 @@ namespace BattleBitAPI.Server
{
}
public virtual async Task OnAPlayerRevivedAnotherPlayer(TPlayer from,TPlayer to)
public virtual async Task OnAPlayerRevivedAnotherPlayer(TPlayer from, TPlayer to)
{
}
@ -555,46 +584,6 @@ namespace BattleBitAPI.Server
{
Heal(player.SteamID, heal);
}
public void SetRunningSpeedMultiplier(ulong steamID, float value)
{
ExecuteCommand("setrunningspeed " + steamID + " " + value);
}
public void SetRunningSpeedMultiplier(Player<TPlayer> player, float value)
{
SetRunningSpeedMultiplier(player.SteamID, value);
}
public void SetReceiveDamageMultiplier(ulong steamID, float value)
{
ExecuteCommand("setreceivedamagemultiplier " + steamID + " " + value);
}
public void SetReceiveDamageMultiplier(Player<TPlayer> player, float value)
{
SetReceiveDamageMultiplier(player.SteamID, value);
}
public void SetGiveDamageMultiplier(ulong steamID, float value)
{
ExecuteCommand("setgivedamagemultiplier " + steamID + " " + value);
}
public void SetGiveDamageMultiplier(Player<TPlayer> player, float value)
{
SetGiveDamageMultiplier(player.SteamID, value);
}
public void SetJumpMultiplier(ulong steamID, float value)
{
ExecuteCommand("setjumpmultiplier " + steamID + " " + value);
}
public void SetJumpMultiplier(Player<TPlayer> player, float value)
{
SetJumpMultiplier(player.SteamID, value);
}
public void SetFallDamageMultiplier(ulong steamID, float value)
{
ExecuteCommand("setfalldamagemultiplier " + steamID + " " + value);
}
public void SetFallDamageMultiplier(Player<TPlayer> player, float value)
{
SetFallDamageMultiplier(player.SteamID, value);
}
public void SetPrimaryWeapon(ulong steamID, WeaponItem item, int extraMagazines, bool clear = false)
{
@ -759,6 +748,7 @@ namespace BattleBitAPI.Server
public int GamePort;
public TcpClient Socket;
public Func<GameServer<TPlayer>, Internal, Common.Serialization.Stream, Task> mExecutionFunc;
public Func<ulong, Player<TPlayer>.Internal> mGetInternals;
public bool IsPasswordProtected;
public string ServerName;
public string Gamemode;
@ -786,6 +776,7 @@ namespace BattleBitAPI.Server
public long mLastPackageSent;
public bool mWantsToCloseConnection;
public StringBuilder mBuilder;
public Queue<(ulong steamID, PlayerModifications<TPlayer>.mPlayerModifications)> mChangedModifications;
public Internal()
{
@ -816,17 +807,18 @@ namespace BattleBitAPI.Server
this.MapRotation = new MapRotation<TPlayer>(this);
this.GamemodeRotation = new GamemodeRotation<TPlayer>(this);
this.RoundSettings = new RoundSettings<TPlayer>(this);
this.mChangedModifications = new Queue<(ulong steamID, PlayerModifications<TPlayer>.mPlayerModifications)>(254);
}
// ---- Players In Room ----
public Dictionary<ulong, Player<TPlayer>> Players = new Dictionary<ulong, Player<TPlayer>>(254);
// ---- Room Settings ----
public mRoomSettings _RoomSettings = new mRoomSettings();
public ServerSettings<TPlayer>.mRoomSettings _RoomSettings = new ServerSettings<TPlayer>.mRoomSettings();
public bool IsDirtyRoomSettings;
// ---- Round Settings ----
public mRoundSettings _RoundSettings = new mRoundSettings();
public RoundSettings<TPlayer>.mRoundSettings _RoundSettings = new RoundSettings<TPlayer>.mRoundSettings();
public bool IsDirtyRoundSettings;
// ---- Map Rotation ----
@ -838,7 +830,24 @@ namespace BattleBitAPI.Server
public bool IsDirtyGamemodeRotation = false;
// ---- Public Functions ----
public void Set(Func<GameServer<TPlayer>, Internal, Common.Serialization.Stream, Task> func, TcpClient socket, IPAddress iP, int port, bool isPasswordProtected, string serverName, string gamemode, string map, MapSize mapSize, MapDayNight dayNight, int currentPlayers, int inQueuePlayers, int maxPlayers, string loadingScreenText, string serverRulesText)
public void Set(
Func<GameServer<TPlayer>, Internal, Common.Serialization.Stream, Task> func,
Func<ulong, Player<TPlayer>.Internal> internalGetFunc,
TcpClient socket,
IPAddress iP,
int port,
bool isPasswordProtected,
string serverName,
string gamemode,
string map,
MapSize mapSize,
MapDayNight dayNight,
int currentPlayers,
int inQueuePlayers,
int maxPlayers,
string loadingScreenText,
string serverRulesText
)
{
this.ServerHash = ((ulong)port << 32) | (ulong)iP.ToUInt();
this.IsConnected = true;
@ -846,6 +855,7 @@ namespace BattleBitAPI.Server
this.GamePort = port;
this.Socket = socket;
this.mExecutionFunc = func;
this.mGetInternals = internalGetFunc;
this.IsPasswordProtected = isPasswordProtected;
this.ServerName = serverName;
this.Gamemode = gamemode;
@ -884,6 +894,7 @@ namespace BattleBitAPI.Server
this.mLastPackageSent = Extentions.TickCount;
this.mWantsToCloseConnection = false;
this.mBuilder.Clear();
this.mChangedModifications.Clear();
}
public void AddPlayer(Player<TPlayer> player)
{
@ -904,117 +915,5 @@ namespace BattleBitAPI.Server
return Players.TryGetValue(steamID, out result);
}
}
public class mRoomSettings
{
public float DamageMultiplier = 1.0f;
public bool BleedingEnabled = true;
public bool StaminaEnabled = false;
public bool FriendlyFireEnabled = false;
public bool HideMapVotes = true;
public bool OnlyWinnerTeamCanVote = false;
public bool HitMarkersEnabled = true;
public bool PointLogEnabled = true;
public bool SpectatorEnabled = true;
public float CaptureFlagSpeedMultiplier = 1f;
public byte MedicLimitPerSquad = 8;
public byte EngineerLimitPerSquad = 8;
public byte SupportLimitPerSquad = 8;
public byte ReconLimitPerSquad = 8;
public void Write(Common.Serialization.Stream ser)
{
ser.Write(this.DamageMultiplier);
ser.Write(this.BleedingEnabled);
ser.Write(this.StaminaEnabled);
ser.Write(this.FriendlyFireEnabled);
ser.Write(this.HideMapVotes);
ser.Write(this.OnlyWinnerTeamCanVote);
ser.Write(this.HitMarkersEnabled);
ser.Write(this.PointLogEnabled);
ser.Write(this.SpectatorEnabled);
ser.Write(this.CaptureFlagSpeedMultiplier);
ser.Write(this.MedicLimitPerSquad);
ser.Write(this.EngineerLimitPerSquad);
ser.Write(this.SupportLimitPerSquad);
ser.Write(this.ReconLimitPerSquad);
}
public void Read(Common.Serialization.Stream ser)
{
this.DamageMultiplier = ser.ReadFloat();
this.BleedingEnabled = ser.ReadBool();
this.StaminaEnabled = ser.ReadBool();
this.FriendlyFireEnabled = ser.ReadBool();
this.HideMapVotes = ser.ReadBool();
this.OnlyWinnerTeamCanVote = ser.ReadBool();
this.HitMarkersEnabled = ser.ReadBool();
this.PointLogEnabled = ser.ReadBool();
this.SpectatorEnabled = ser.ReadBool();
this.CaptureFlagSpeedMultiplier = ser.ReadFloat();
this.MedicLimitPerSquad = ser.ReadInt8();
this.EngineerLimitPerSquad = ser.ReadInt8();
this.SupportLimitPerSquad = ser.ReadInt8();
this.ReconLimitPerSquad = ser.ReadInt8();
}
public void Reset()
{
this.DamageMultiplier = 1.0f;
this.BleedingEnabled = true;
this.StaminaEnabled = false;
this.FriendlyFireEnabled = false;
this.HideMapVotes = true;
this.OnlyWinnerTeamCanVote = false;
this.HitMarkersEnabled = true;
this.PointLogEnabled = true;
this.SpectatorEnabled = true;
this.MedicLimitPerSquad = 8;
this.EngineerLimitPerSquad = 8;
this.SupportLimitPerSquad = 8;
this.ReconLimitPerSquad = 8;
}
}
public class mRoundSettings
{
public const int Size = 1 + 8 + 8 + 8 + 4 + 4;
public GameState State = GameState.WaitingForPlayers;
public double TeamATickets = 0;
public double TeamBTickets = 0;
public double MaxTickets = 1;
public int PlayersToStart = 16;
public int SecondsLeft = 60;
public void Write(Common.Serialization.Stream ser)
{
ser.Write((byte)this.State);
ser.Write(this.TeamATickets);
ser.Write(this.TeamBTickets);
ser.Write(this.MaxTickets);
ser.Write(this.PlayersToStart);
ser.Write(this.SecondsLeft);
}
public void Read(Common.Serialization.Stream ser)
{
this.State = (GameState)ser.ReadInt8();
this.TeamATickets = ser.ReadDouble();
this.TeamBTickets = ser.ReadDouble();
this.MaxTickets = ser.ReadDouble();
this.PlayersToStart = ser.ReadInt32();
this.SecondsLeft = ser.ReadInt32();
}
public void Reset()
{
this.State = GameState.WaitingForPlayers;
this.TeamATickets = 0;
this.TeamBTickets = 0;
this.MaxTickets = 1;
this.PlayersToStart = 16;
this.SecondsLeft = 60;
}
}
}
}

2
BattleBitAPI/Server/Internal/GamemodeRotation.cs
View File

@ -1,4 +1,4 @@
using BattleBitAPI.Common;
using BattleBitAPI.Common;
using BattleBitAPI.Server;
namespace BattleBitAPI.Server

2
BattleBitAPI/Server/Internal/MapRotation.cs
View File

@ -1,4 +1,4 @@
using BattleBitAPI.Server;
using BattleBitAPI.Server;
namespace BattleBitAPI.Server
{

415
BattleBitAPI/Server/Internal/PlayerModifications.cs
View File

@ -2,27 +2,410 @@
{
public class PlayerModifications<TPlayer> where TPlayer : Player<TPlayer>
{
// ---- Construction ----
private Player<TPlayer>.Internal @internal;
public PlayerModifications(Player<TPlayer>.Internal @internal)
{
this.@internal = @internal;
}
public float RunningSpeedMultiplier { get; set; }
public float ReceiveDamageMultiplier { get; set; }
public float GiveDamageMultiplier { get; set; }
public float JumpHeightMultiplier { get; set; }
public float FallDamageMultiplier { get; set; }
public float ReloadSpeedMultiplier { get; set; }
public bool CanUseNightVision { get; set; }
public bool HasCollision { get; set; }
public float DownTimeGiveUpTime { get; set; }
public bool AirStrafe { get; set; }
public bool CanSpawn { get; set; }
public bool CanSpectate { get; set; }
public bool IsTextChatMuted { get; set; }
public bool IsVoiceChatMuted { get; set; }
public float RespawnTime { get; set; }
public bool CanRespawn { get; set; }
// ---- Variables ----
public float RunningSpeedMultiplier
{
get => @internal._Modifications.RunningSpeedMultiplier;
set
{
if (@internal._Modifications.RunningSpeedMultiplier == value)
return;
@internal._Modifications.RunningSpeedMultiplier = value;
@internal._Modifications.IsDirtyFlag = true;
}
}
public float ReceiveDamageMultiplier
{
get => @internal._Modifications.ReceiveDamageMultiplier;
set
{
if (@internal._Modifications.ReceiveDamageMultiplier == value)
return;
@internal._Modifications.ReceiveDamageMultiplier = value;
@internal._Modifications.IsDirtyFlag = true;
}
}
public float GiveDamageMultiplier
{
get => @internal._Modifications.GiveDamageMultiplier;
set
{
if (@internal._Modifications.GiveDamageMultiplier == value)
return;
@internal._Modifications.GiveDamageMultiplier = value;
@internal._Modifications.IsDirtyFlag = true;
}
}
public float JumpHeightMultiplier
{
get => @internal._Modifications.JumpHeightMultiplier;
set
{
if (@internal._Modifications.JumpHeightMultiplier == value)
return;
@internal._Modifications.JumpHeightMultiplier = value;
@internal._Modifications.IsDirtyFlag = true;
}
}
public float FallDamageMultiplier
{
get => @internal._Modifications.FallDamageMultiplier;
set
{
if (@internal._Modifications.FallDamageMultiplier == value)
return;
@internal._Modifications.FallDamageMultiplier = value;
@internal._Modifications.IsDirtyFlag = true;
}
}
public float ReloadSpeedMultiplier
{
get => @internal._Modifications.ReloadSpeedMultiplier;
set
{
if (@internal._Modifications.ReloadSpeedMultiplier == value)
return;
@internal._Modifications.ReloadSpeedMultiplier = value;
@internal._Modifications.IsDirtyFlag = true;
}
}
public bool CanUseNightVision
{
get => @internal._Modifications.CanUseNightVision;
set
{
if (@internal._Modifications.CanUseNightVision == value)
return;
@internal._Modifications.CanUseNightVision = value;
@internal._Modifications.IsDirtyFlag = true;
}
}
public float DownTimeGiveUpTime
{
get => @internal._Modifications.DownTimeGiveUpTime;
set
{
if (@internal._Modifications.DownTimeGiveUpTime == value)
return;
@internal._Modifications.DownTimeGiveUpTime = value;
@internal._Modifications.IsDirtyFlag = true;
}
}
public bool AirStrafe
{
get => @internal._Modifications.AirStrafe;
set
{
if (@internal._Modifications.AirStrafe == value)
return;
@internal._Modifications.AirStrafe = value;
@internal._Modifications.IsDirtyFlag = true;
}
}
public bool CanDeploy
{
get => @internal._Modifications.CanDeploy;
set
{
if (@internal._Modifications.CanDeploy == value)
return;
@internal._Modifications.CanDeploy = value;
@internal._Modifications.IsDirtyFlag = true;
}
}
public bool CanSpectate
{
get => @internal._Modifications.CanSpectate;
set
{
if (@internal._Modifications.CanSpectate == value)
return;
@internal._Modifications.CanSpectate = value;
@internal._Modifications.IsDirtyFlag = true;
}
}
public bool IsTextChatMuted
{
get => @internal._Modifications.IsTextChatMuted;
set
{
if (@internal._Modifications.IsTextChatMuted == value)
return;
@internal._Modifications.IsTextChatMuted = value;
@internal._Modifications.IsDirtyFlag = true;
}
}
public bool IsVoiceChatMuted
{
get => @internal._Modifications.IsVoiceChatMuted;
set
{
if (@internal._Modifications.IsVoiceChatMuted == value)
return;
@internal._Modifications.IsVoiceChatMuted = value;
@internal._Modifications.IsDirtyFlag = true;
}
}
public float RespawnTime
{
get => @internal._Modifications.RespawnTime;
set
{
if (@internal._Modifications.RespawnTime == value)
return;
@internal._Modifications.RespawnTime = value;
@internal._Modifications.IsDirtyFlag = true;
}
}
public bool CanSuicide
{
get => @internal._Modifications.CanSuicide;
set
{
if (@internal._Modifications.CanSuicide == value)
return;
@internal._Modifications.CanSuicide = value;
@internal._Modifications.IsDirtyFlag = true;
}
}
public float MinimumDamageToStartBleeding
{
get => @internal._Modifications.MinDamageToStartBleeding;
set
{
if (@internal._Modifications.MinDamageToStartBleeding == value)
return;
@internal._Modifications.MinDamageToStartBleeding = value;
@internal._Modifications.IsDirtyFlag = true;
}
}
public float MinimumHpToStartBleeding
{
get => @internal._Modifications.MinHpToStartBleeding;
set
{
if (@internal._Modifications.MinHpToStartBleeding == value)
return;
@internal._Modifications.MinHpToStartBleeding = value;
@internal._Modifications.IsDirtyFlag = true;
}
}
public float HpPerBandage
{
get => @internal._Modifications.HPperBandage;
set
{
if (value >= 100f)
value = 100f;
else if (value < 0)
value = 0f;
if (@internal._Modifications.HPperBandage == value)
return;
@internal._Modifications.HPperBandage = value;
@internal._Modifications.IsDirtyFlag = true;
}
}
public bool StaminaEnabled
{
get => @internal._Modifications.StaminaEnabled;
set
{
if (@internal._Modifications.StaminaEnabled == value)
return;
@internal._Modifications.StaminaEnabled = value;
@internal._Modifications.IsDirtyFlag = true;
}
}
public bool HitMarkersEnabled
{
get => @internal._Modifications.HitMarkersEnabled;
set
{
if (@internal._Modifications.HitMarkersEnabled == value)
return;
@internal._Modifications.HitMarkersEnabled = value;
@internal._Modifications.IsDirtyFlag = true;
}
}
public bool FriendlyHUDEnabled
{
get => @internal._Modifications.FriendlyHUDEnabled;
set
{
if (@internal._Modifications.FriendlyHUDEnabled == value)
return;
@internal._Modifications.FriendlyHUDEnabled = value;
@internal._Modifications.IsDirtyFlag = true;
}
}
public float CaptureFlagSpeedMultiplier
{
get => @internal._Modifications.CaptureFlagSpeedMultiplier;
set
{
if (@internal._Modifications.CaptureFlagSpeedMultiplier == value)
return;
@internal._Modifications.CaptureFlagSpeedMultiplier = value;
@internal._Modifications.IsDirtyFlag = true;
}
}
public bool PointLogHudEnabled
{
get => @internal._Modifications.PointLogHudEnabled;
set
{
if (@internal._Modifications.PointLogHudEnabled == value)
return;
@internal._Modifications.PointLogHudEnabled = value;
@internal._Modifications.IsDirtyFlag = true;
}
}
public bool KillFeed
{
get => @internal._Modifications.KillFeed;
set
{
if (@internal._Modifications.KillFeed == value)
return;
@internal._Modifications.KillFeed = value;
@internal._Modifications.IsDirtyFlag = true;
}
}
public void DisableBleeding()
{
this.MinimumDamageToStartBleeding = 100f;
this.MinimumHpToStartBleeding = 0f;
}
public void EnableBleeding(float minimumHP = 40f, float minimumDamage = 10f)
{
this.MinimumDamageToStartBleeding = minimumDamage;
this.MinimumHpToStartBleeding = minimumHP;
}
// ---- Classes ----
public class mPlayerModifications
{
public float RunningSpeedMultiplier = 1f;
public float ReceiveDamageMultiplier = 1f;
public float GiveDamageMultiplier = 1f;
public float JumpHeightMultiplier = 1f;
public float FallDamageMultiplier = 1f;
public float ReloadSpeedMultiplier = 1f;
public bool CanUseNightVision = true;
public float DownTimeGiveUpTime = 60f;
public bool AirStrafe = true;
public bool CanDeploy = true;
public bool CanSpectate = true;
public bool IsTextChatMuted = false;
public bool IsVoiceChatMuted = false;
public float RespawnTime = 10f;
public bool CanSuicide = true;
public float MinDamageToStartBleeding = 10f;
public float MinHpToStartBleeding = 40f;
public float HPperBandage = 40f;
public bool StaminaEnabled = false;
public bool HitMarkersEnabled = true;
public bool FriendlyHUDEnabled = true;
public float CaptureFlagSpeedMultiplier = 1f;
public bool PointLogHudEnabled = true;
public bool KillFeed = false;
public bool IsDirtyFlag = false;
public void Write(BattleBitAPI.Common.Serialization.Stream ser)
{
ser.Write(this.RunningSpeedMultiplier);
ser.Write(this.ReceiveDamageMultiplier);
ser.Write(this.GiveDamageMultiplier);
ser.Write(this.JumpHeightMultiplier);
ser.Write(this.FallDamageMultiplier);
ser.Write(this.ReloadSpeedMultiplier);
ser.Write(this.CanUseNightVision);
ser.Write(this.DownTimeGiveUpTime);
ser.Write(this.AirStrafe);
ser.Write(this.CanDeploy);
ser.Write(this.CanSpectate);
ser.Write(this.IsTextChatMuted);
ser.Write(this.IsVoiceChatMuted);
ser.Write(this.RespawnTime);
ser.Write(this.CanSuicide);
ser.Write(this.MinDamageToStartBleeding);
ser.Write(this.MinHpToStartBleeding);
ser.Write(this.HPperBandage);
ser.Write(this.StaminaEnabled);
ser.Write(this.HitMarkersEnabled);
ser.Write(this.FriendlyHUDEnabled);
ser.Write(this.CaptureFlagSpeedMultiplier);
ser.Write(this.PointLogHudEnabled);
ser.Write(this.KillFeed);
}
public void Read(BattleBitAPI.Common.Serialization.Stream ser)
{
this.RunningSpeedMultiplier = ser.ReadFloat();
if (this.RunningSpeedMultiplier <= 0f)
this.RunningSpeedMultiplier = 0.01f;
this.ReceiveDamageMultiplier = ser.ReadFloat();
this.GiveDamageMultiplier = ser.ReadFloat();
this.JumpHeightMultiplier = ser.ReadFloat();
this.FallDamageMultiplier = ser.ReadFloat();
this.ReloadSpeedMultiplier = ser.ReadFloat();
this.CanUseNightVision = ser.ReadBool();
this.DownTimeGiveUpTime = ser.ReadFloat();
this.AirStrafe = ser.ReadBool();
this.CanDeploy = ser.ReadBool();
this.CanSpectate = ser.ReadBool();
this.IsTextChatMuted = ser.ReadBool();
this.IsVoiceChatMuted = ser.ReadBool();
this.RespawnTime = ser.ReadFloat();
this.CanSuicide = ser.ReadBool();
this.MinDamageToStartBleeding = ser.ReadFloat();
this.MinHpToStartBleeding = ser.ReadFloat();
this.HPperBandage = ser.ReadFloat();
this.StaminaEnabled = ser.ReadBool();
this.HitMarkersEnabled = ser.ReadBool();
this.FriendlyHUDEnabled = ser.ReadBool();
this.CaptureFlagSpeedMultiplier = ser.ReadFloat();
this.PointLogHudEnabled = ser.ReadBool();
this.KillFeed = ser.ReadBool();
}
public void Reset()
{
this.RunningSpeedMultiplier = 1f;
this.ReceiveDamageMultiplier = 1f;
this.GiveDamageMultiplier = 1f;
this.JumpHeightMultiplier = 1f;
this.FallDamageMultiplier = 1f;
this.ReloadSpeedMultiplier = 1f;
this.CanUseNightVision = true;
this.DownTimeGiveUpTime = 60f;
this.AirStrafe = true;
this.CanDeploy = true;
this.CanSpectate = true;
this.IsTextChatMuted = false;
this.IsVoiceChatMuted = false;
this.RespawnTime = 10f;
this.CanSuicide = true;
this.MinDamageToStartBleeding = 10f;
this.MinHpToStartBleeding = 40f;
this.HPperBandage = 40f;
this.StaminaEnabled = false;
this.HitMarkersEnabled = true;
this.FriendlyHUDEnabled = true;
this.CaptureFlagSpeedMultiplier = 1f;
this.PointLogHudEnabled = true;
this.KillFeed = false;
}
}
}
}

47
BattleBitAPI/Server/Internal/RoundSettings.cs
View File

@ -1,16 +1,18 @@
using BattleBitAPI.Common;
using BattleBitAPI.Common;
using BattleBitAPI.Server;
namespace BattleBitAPI.Server
{
public class RoundSettings<TPlayer> where TPlayer : Player<TPlayer>
{
// ---- Construction ----
private GameServer<TPlayer>.Internal mResources;
public RoundSettings(GameServer<TPlayer>.Internal resources)
{
mResources = resources;
}
// ---- Variables ----
public GameState State
{
get => this.mResources._RoundSettings.State;
@ -61,9 +63,52 @@ namespace BattleBitAPI.Server
}
}
// ---- Reset ----
public void Reset()
{
}
// ---- Classes ----
public class mRoundSettings
{
public const int Size = 1 + 8 + 8 + 8 + 4 + 4;
public GameState State = GameState.WaitingForPlayers;
public double TeamATickets = 0;
public double TeamBTickets = 0;
public double MaxTickets = 1;
public int PlayersToStart = 16;
public int SecondsLeft = 60;
public void Write(Common.Serialization.Stream ser)
{
ser.Write((byte)this.State);
ser.Write(this.TeamATickets);
ser.Write(this.TeamBTickets);
ser.Write(this.MaxTickets);
ser.Write(this.PlayersToStart);
ser.Write(this.SecondsLeft);
}
public void Read(Common.Serialization.Stream ser)
{
this.State = (GameState)ser.ReadInt8();
this.TeamATickets = ser.ReadDouble();
this.TeamBTickets = ser.ReadDouble();
this.MaxTickets = ser.ReadDouble();
this.PlayersToStart = ser.ReadInt32();
this.SecondsLeft = ser.ReadInt32();
}
public void Reset()
{
this.State = GameState.WaitingForPlayers;
this.TeamATickets = 0;
this.TeamBTickets = 0;
this.MaxTickets = 1;
this.PlayersToStart = 16;
this.SecondsLeft = 60;
}
}
}
}

111
BattleBitAPI/Server/Internal/ServerSettings.cs
View File

@ -1,47 +1,35 @@
using BattleBitAPI.Server;
using BattleBitAPI.Server;
namespace BattleBitAPI.Server
{
public class ServerSettings<TPlayer> where TPlayer : Player<TPlayer>
{
// ---- Construction ----
private GameServer<TPlayer>.Internal mResources;
public ServerSettings(GameServer<TPlayer>.Internal resources)
{
mResources = resources;
}
// ---- Variables ----
public float DamageMultiplier
{
get => mResources._RoomSettings.DamageMultiplier;
set
{
if (mResources._RoomSettings.DamageMultiplier == value)
return;
mResources._RoomSettings.DamageMultiplier = value;
mResources.IsDirtyRoomSettings = true;
}
}
public bool BleedingEnabled
{
get => mResources._RoomSettings.BleedingEnabled;
set
{
mResources._RoomSettings.BleedingEnabled = value;
mResources.IsDirtyRoomSettings = true;
}
}
public bool StamineEnabled
{
get => mResources._RoomSettings.StaminaEnabled;
set
{
mResources._RoomSettings.StaminaEnabled = value;
mResources.IsDirtyRoomSettings = true;
}
}
public bool FriendlyFireEnabled
{
get => mResources._RoomSettings.FriendlyFireEnabled;
set
{
if (mResources._RoomSettings.FriendlyFireEnabled == value)
return;
mResources._RoomSettings.FriendlyFireEnabled = value;
mResources.IsDirtyRoomSettings = true;
}
@ -51,41 +39,82 @@ namespace BattleBitAPI.Server
get => mResources._RoomSettings.OnlyWinnerTeamCanVote;
set
{
if (mResources._RoomSettings.OnlyWinnerTeamCanVote == value)
return;
mResources._RoomSettings.OnlyWinnerTeamCanVote = value;
mResources.IsDirtyRoomSettings = true;
}
}
public bool HitMarkersEnabled
public bool PlayerCollision
{
get => mResources._RoomSettings.HitMarkersEnabled;
get => mResources._RoomSettings.PlayerCollision;
set
{
mResources._RoomSettings.HitMarkersEnabled = value;
mResources.IsDirtyRoomSettings = true;
}
}
public bool PointLogEnabled
{
get => mResources._RoomSettings.PointLogEnabled;
set
{
mResources._RoomSettings.PointLogEnabled = value;
mResources.IsDirtyRoomSettings = true;
}
}
public bool SpectatorEnabled
{
get => mResources._RoomSettings.SpectatorEnabled;
set
{
mResources._RoomSettings.SpectatorEnabled = value;
if (mResources._RoomSettings.PlayerCollision == value)
return;
mResources._RoomSettings.PlayerCollision = value;
mResources.IsDirtyRoomSettings = true;
}
}
// ---- Reset ----
public void Reset()
{
}
// ---- Classes ----
public class mRoomSettings
{
public float DamageMultiplier = 1.0f;
public bool FriendlyFireEnabled = false;
public bool HideMapVotes = true;
public bool OnlyWinnerTeamCanVote = false;
public bool PlayerCollision = false;
public byte MedicLimitPerSquad = 8;
public byte EngineerLimitPerSquad = 8;
public byte SupportLimitPerSquad = 8;
public byte ReconLimitPerSquad = 8;
public void Write(Common.Serialization.Stream ser)
{
ser.Write(this.DamageMultiplier);
ser.Write(this.FriendlyFireEnabled);
ser.Write(this.HideMapVotes);
ser.Write(this.OnlyWinnerTeamCanVote);
ser.Write(this.PlayerCollision);
ser.Write(this.MedicLimitPerSquad);
ser.Write(this.EngineerLimitPerSquad);
ser.Write(this.SupportLimitPerSquad);
ser.Write(this.ReconLimitPerSquad);
}
public void Read(Common.Serialization.Stream ser)
{
this.DamageMultiplier = ser.ReadFloat();
this.FriendlyFireEnabled = ser.ReadBool();
this.HideMapVotes = ser.ReadBool();
this.OnlyWinnerTeamCanVote = ser.ReadBool();
this.PlayerCollision=ser.ReadBool();
this.MedicLimitPerSquad = ser.ReadInt8();
this.EngineerLimitPerSquad = ser.ReadInt8();
this.SupportLimitPerSquad = ser.ReadInt8();
this.ReconLimitPerSquad = ser.ReadInt8();
}
public void Reset()
{
this.DamageMultiplier = 1.0f;
this.FriendlyFireEnabled = false;
this.HideMapVotes = true;
this.OnlyWinnerTeamCanVote = false;
this.PlayerCollision = false;
this.MedicLimitPerSquad = 8;
this.EngineerLimitPerSquad = 8;
this.SupportLimitPerSquad = 8;
this.ReconLimitPerSquad = 8;
}
}
}
}

104
BattleBitAPI/Server/Player.cs
View File

@ -49,7 +49,23 @@ namespace BattleBitAPI
public bool InSquad => mInternal.Squad != Squads.NoSquad;
public int PingMs => mInternal.PingMs;
public float HP => mInternal.HP;
public float HP
{
get => mInternal.HP;
set
{
if (mInternal.HP > 0)
{
float v = value;
if (v <= 0)
v = 0.1f;
else if (v > 100f)
v = 100f;
SetHP(v);
}
}
}
public bool IsAlive => mInternal.HP >= 0f;
public bool IsUp => mInternal.HP > 0f;
public bool IsDown => mInternal.HP == 0f;
@ -193,26 +209,6 @@ namespace BattleBitAPI
{
GameServer.Heal(this, hp);
}
public void SetRunningSpeedMultiplier(float value)
{
GameServer.SetRunningSpeedMultiplier(this, value);
}
public void SetReceiveDamageMultiplier(float value)
{
GameServer.SetReceiveDamageMultiplier(this, value);
}
public void SetGiveDamageMultiplier(float value)
{
GameServer.SetGiveDamageMultiplier(this, value);
}
public void SetJumpMultiplier(float value)
{
GameServer.SetJumpMultiplier(this, value);
}
public void SetFallDamageMultiplier(float value)
{
GameServer.SetFallDamageMultiplier(this, value);
}
public void SetPrimaryWeapon(WeaponItem item, int extraMagazines, bool clear = false)
{
GameServer.SetPrimaryWeapon(this, item, extraMagazines, clear);
@ -275,13 +271,13 @@ namespace BattleBitAPI
public PlayerLoadout CurrentLoadout;
public PlayerWearings CurrentWearings;
public mPlayerModifications _Modifications;
public PlayerModifications<TPlayer>.mPlayerModifications _Modifications;
public PlayerModifications<TPlayer> Modifications;
public Internal()
{
this._Modifications = new PlayerModifications<TPlayer>.mPlayerModifications();
this.Modifications = new PlayerModifications<TPlayer>(this);
this._Modifications = new mPlayerModifications();
}
public void OnDie()
@ -298,67 +294,5 @@ namespace BattleBitAPI
CurrentWearings = new PlayerWearings();
}
}
public class mPlayerModifications
{
public float RunningSpeedMultiplier = 1f;
public float ReceiveDamageMultiplier = 1f;
public float GiveDamageMultiplier = 1f;
public float JumpHeightMultiplier = 1f;
public float FallDamageMultiplier = 1f;
public float ReloadSpeedMultiplier = 1f;
public bool CanUseNightVision = true;
public bool HasCollision = false;
public float DownTimeGiveUpTime = 60f;
public bool AirStrafe = true;
public bool CanSpawn = true;
public bool CanSpectate = true;
public bool IsTextChatMuted = false;
public bool IsVoiceChatMuted = false;
public float RespawnTime = 10f;
public bool CanRespawn = true;
public bool IsDirtyFlag = false;
public void Write(BattleBitAPI.Common.Serialization.Stream ser)
{
ser.Write(this.RunningSpeedMultiplier);
ser.Write(this.ReceiveDamageMultiplier);
ser.Write(this.GiveDamageMultiplier);
ser.Write(this.JumpHeightMultiplier);
ser.Write(this.FallDamageMultiplier);
ser.Write(this.ReloadSpeedMultiplier);
ser.Write(this.CanUseNightVision);
ser.Write(this.HasCollision);
ser.Write(this.DownTimeGiveUpTime);
ser.Write(this.AirStrafe);
ser.Write(this.CanSpawn);
ser.Write(this.CanSpectate);
ser.Write(this.IsTextChatMuted);
ser.Write(this.IsVoiceChatMuted);
ser.Write(this.RespawnTime);
ser.Write(this.CanRespawn);
}
public void Read(BattleBitAPI.Common.Serialization.Stream ser)
{
this.RunningSpeedMultiplier = ser.ReadFloat();
if (this.RunningSpeedMultiplier <= 0f)
this.RunningSpeedMultiplier = 0.01f;
this.ReceiveDamageMultiplier = ser.ReadFloat();
this.GiveDamageMultiplier = ser.ReadFloat();
this.JumpHeightMultiplier = ser.ReadFloat();
this.FallDamageMultiplier = ser.ReadFloat();
this.ReloadSpeedMultiplier = ser.ReadFloat();
this.CanUseNightVision = ser.ReadBool();
this.HasCollision = ser.ReadBool();
this.DownTimeGiveUpTime = ser.ReadFloat();
this.AirStrafe = ser.ReadBool();
this.CanSpawn = ser.ReadBool();
this.CanSpectate = ser.ReadBool();
this.IsTextChatMuted = ser.ReadBool();
this.IsVoiceChatMuted = ser.ReadBool();
this.RespawnTime = ser.ReadFloat();
this.CanRespawn = ser.ReadBool();
}
}
}
}

73
BattleBitAPI/Server/ServerListener.cs
View File

@ -1,12 +1,8 @@
using System.Diagnostics;
using System.Net;
using System.Net.Security;
using System.Net.Sockets;
using System.Numerics;
using System.Xml;
using BattleBitAPI.Common;
using BattleBitAPI.Common.Extentions;
using BattleBitAPI.Common.Serialization;
using BattleBitAPI.Networking;
using CommunityServerAPI.BattleBitAPI;
using BattleBitAPI.Server;
@ -35,6 +31,22 @@ namespace BattleBitAPI.Server
/// </value>
public Func<IPAddress, Task<bool>> OnGameServerConnecting { get; set; }
/// <summary>
/// Fired when server needs to validate token from incoming connection.<br/>
/// Default, any connection attempt will be accepted
/// </summary>
///
/// <remarks>
/// IPAddress: IP of incoming connection <br/>
/// ushort: Game Port of the connection <br/>
/// string: Token of connection<br/>
/// </remarks>
///
/// <value>
/// Returns: true if allow connection, false if deny the connection.
/// </value>
public Func<IPAddress, ushort, string, Task<bool>> OnValidateGameServerToken { get; set; }
/// <summary>
/// Fired when a game server connects.
/// </summary>
@ -178,6 +190,24 @@ namespace BattleBitAPI.Server
throw new Exception("Incoming package wasn't hail.");
}
//Read the server name
string token;
{
readStream.Reset();
if (!await networkStream.TryRead(readStream, 2, source.Token))
throw new Exception("Unable to read the Token Size");
int stringSize = readStream.ReadUInt16();
if (stringSize > Const.MaxTokenSize)
throw new Exception("Invalid token size");
readStream.Reset();
if (!await networkStream.TryRead(readStream, stringSize, source.Token))
throw new Exception("Unable to read the token");
token = readStream.ReadString(stringSize);
}
//Read port
int gamePort;
{
@ -187,6 +217,12 @@ namespace BattleBitAPI.Server
gamePort = readStream.ReadUInt16();
}
if (OnValidateGameServerToken != null)
allow = await OnValidateGameServerToken(ip, (ushort)gamePort, token);
if (!allow)
throw new Exception("Token was not valid!");
//Read is server protected
bool isPasswordProtected;
{
@ -349,6 +385,7 @@ namespace BattleBitAPI.Server
server = this.mInstanceDatabase.GetServerInstance(hash, out bool isNew, out resources);
resources.Set(
this.mExecutePackage,
this.mGetPlayerInternals,
client,
ip,
gamePort,
@ -409,7 +446,7 @@ namespace BattleBitAPI.Server
//Round Settings
{
readStream.Reset();
if (!await networkStream.TryRead(readStream, GameServer<TPlayer>.mRoundSettings.Size, source.Token))
if (!await networkStream.TryRead(readStream, RoundSettings<TPlayer>.mRoundSettings.Size, source.Token))
throw new Exception("Unable to read the round settings");
resources._RoundSettings.Read(readStream);
}
@ -531,13 +568,26 @@ namespace BattleBitAPI.Server
playerInternal.CurrentLoadout = loadout;
playerInternal.CurrentWearings = wearings;
//Modifications
{
readStream.Reset();
if (!await networkStream.TryRead(readStream, 4, source.Token))
throw new Exception("Unable to read the Modifications Size");
int modificationSize = (int)readStream.ReadUInt32();
readStream.Reset();
if (!await networkStream.TryRead(readStream, modificationSize, source.Token))
throw new Exception("Unable to read the Modifications");
playerInternal._Modifications.Read(readStream);
}
//Call new instance callback if needed.
if (isNewClient)
{
if (this.OnCreatingPlayerInstance != null)
this.OnCreatingPlayerInstance(player);
}
resources.AddPlayer(player);
}
@ -677,6 +727,9 @@ namespace BattleBitAPI.Server
playerInternal.Squad = squad;
playerInternal.Role = role;
//Start from default.
playerInternal._Modifications.Reset();
if (isNewClient)
{
if (this.OnCreatingPlayerInstance != null)
@ -1066,7 +1119,7 @@ namespace BattleBitAPI.Server
}
case NetworkCommuncation.NotifyNewRoundState:
{
if (stream.CanRead(GameServer<TPlayer>.mRoundSettings.Size))
if (stream.CanRead(RoundSettings<TPlayer>.mRoundSettings.Size))
{
var oldState = resources._RoundSettings.State;
resources._RoundSettings.Read(stream);
@ -1187,6 +1240,12 @@ namespace BattleBitAPI.Server
}
}
// --- Private ---
private Player<TPlayer>.Internal mGetPlayerInternals(ulong steamID)
{
return mInstanceDatabase.GetPlayerInternals(steamID);
}
// --- Public ---
public IEnumerable<TGameServer> ConnectedGameServers
{

14
Program.cs
View File

@ -1,4 +1,4 @@
using BattleBitAPI;
using BattleBitAPI;
using BattleBitAPI.Common;
using BattleBitAPI.Server;
using CommunityServerAPI;
@ -14,6 +14,18 @@ class Program
Thread.Sleep(-1);
}
private static async Task<bool> OnValidateGameServerToken(IPAddress ip, ushort gameport, string sentToken)
{
await Console.Out.WriteLineAsync(ip + ":" + gameport + " sent " + sentToken);
return true;
}
private static async Task<bool> OnGameServerConnecting(IPAddress arg)
{
await Console.Out.WriteLineAsync(arg.ToString() + " connecting");
return true;
}
}
public class MyPlayer : Player<MyPlayer>

6
README_koKR.md → README-koKR.md
View File

@ -28,8 +28,12 @@ Language [English](/README.md) | [中文](/README-zhCN.md) | 한국어
이 프로젝트는 CMD에서 [`dotnet build`](https://learn.microsoft.com/en-us/dotnet/core/tools/dotnet-build)를 사용하거나 선호하는 IDE에서 Run / Build 옵션을 이용하여 빌드할 수 있습니다.
또는, Docker를 사용할 수 있습니다. 이를 사용하는 쉬운 방법은 `docker compose up`을 실행하는 것입니다.
### Connecting to the gameserver
API를 작성하고 컴파일한 후, 다른 곳에서 호스팅하고 싶을 수도 있습니다. 게임 서버가 실행되는 서버와 동일한 서버일 수 있으며 완전히 다른 서버일 수도 있습니다. 보다 원활하고 빠른 통신을 위해 게임 서버와의 지연 시간을 최소화하는 것이 좋습니다. 동일한 `ServerListener`를 동시에 *여러* 게임 서버에 사용할 수 있습니다. 게임 서버의 실행 옵션에서 API 서버(주소와 포트)를 지정할 수 있습니다.
게임 서버는 실행 인수 `-apiendpoint=<IP>:<PORT>`를 사용하여 API에 연결합니다. 여기서 <PORT>는 리스터가 수신하는 포트이고, IP는 API 서버의 IP입니다.
게임 서버는 실행 인수 `-apiendpoint=<IP>:<PORT>`를 사용하여 API에 연결합니다. 여기서 <PORT>는 리스터가 수신하는 포트이고, IP는 API 서버의 IP입니다.
현재 프로젝트의 API는 `29294` 포트에서 수신 대기하도록 구성되어 있습니다. 이를 변경하려면 `listener.start(port)`에서 변경해야 합니다. `29294` 포트는 Docker에 노출되며 Docker Compose에서 호스트의 동일한 포트에 바인딩됩니다. 즉, Docker를 사용할 때 `Dockerfile` 및 `docker-compose.yml` (Compose를 사용할 때)에서도 포트를 변경해야 합니다. [EXPOSE 문서](https://docs.docker.com/engine/reference/builder/#expose) 와 [NETWORKING 문서](https://docs.docker.com/compose/networking/)를 참고하세요.

22
README-zhCN.md
View File

@ -1,11 +1,11 @@
# BattleBit Remastered 服务器 API
# BattleBit Remastered 服务端 API
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
Language [English](/README.md) | 中文 | [한국어](/README_koKR.md)
Language [English](/README.md) | 中文 | [한국어](/README-koKR.md)
这个 repo 是 BBR（像素战地）的服务端 API
BBR（像素战地）的服务端 API 在部署后可以提供`社区服`所需要的游戏服务端事件处理以及事件控制。
## 如何开始
@ -15,19 +15,23 @@ Language [English](/README.md) | 中文 | [한국어](/README_koKR.md)
- 可以写基于 [.NET 6.0](https://dotnet.microsoft.com/en-us/download/dotnet/6.0) 的 C# 代码。
- 可以在生产环境中部署此代码。
### 如何制作功能
### 制作功能
制作对应的功能可以 [查看维基(制作中)](https://github.com/MrOkiDoki/BattleBit-Community-Server-API/wiki).
使用这个 API 将在运行本程序后开启一个`ServerListener` 的监听进程，传递你*自己定义*的`Player` 和 `GameServer` 类型覆盖原本游戏自身的`Player` 和 `GameServer`类型。在这些类型中添加任何你想要的功能，以此来定制属于你自己的游戏玩法。
如果想给你的服务端添加功能，可以直接把覆盖的功能写在 `Program.cs` 的 `MyPlayer` 和 `MyGameServer`中，当然也可以按照框架规范进行其他的功能纂写。
本 API 将在运行后开启一个`ServerListener` 的监听进程，传递你 *自己定义* 的 `Player` 和 `GameServer` 类型覆盖原本游戏自身的 `Player` 和 `GameServer` 类型。在这些类型中添加任何你想要的功能，以此来定制属于你自己的游戏玩法。
如果想给你的游戏服务端添加功能，可以直接把覆盖的功能写入 `Program.cs` 的 `MyPlayer` 和 `MyGameServer`中，当然你也可以按照框架规范进行其他的功能纂写。
### 编译
可以直接使用 [`dotnet build`](https://learn.microsoft.com/en-us/dotnet/core/tools/dotnet-build) 的命令进行编译，或者在你的 IDE 中自定义编译.
可以直接使用 [`dotnet build`](https://learn.microsoft.com/en-us/dotnet/core/tools/dotnet-build) 的命令进行编译，或者在你的 IDE 中自定义编译。
### 连接服务端
### 连接游戏服务端
当你将此项目的功能写完并进行了编译后，需要将此 API 服务进行部署。此 API 服务可以部署在本地网络、本机网络或者广域网中。我们强烈建议以「最低延迟」为基准进行部署，以保证 `ServerListener` 可以同时监听 *多个* 游戏服务端。
你可以在游戏服务端的启动配置中对 API 的地址和端口进行设定。
游戏服务端通过启动参数 `"-apiEndpoint=<IP>:<端口>"` 来与本 API 实例进行通信, 启动参数中的 `<端口>` 指的是本 API 服务中指定的端口 `<IP>` 指的是本 API 服务部署实例的 IP 地址。
如果游戏服务端实例与本 API 实例不在同一个实例上进行部署，且你想修改本 API 实例的端口 `29294`，你可以查看 `Progran.cs` 中 `listener.Start(29294);` 并把 `29294` 修改为你想指定或防火墙等安全策略已通过的端口号。
如果你的实例运行在 Docker 容器中，端口 `29294` （或你修改的其他端口）也同时需要在 Docker 容器配置中进行修改并对外暴露。也就是说你需要修改 `Dockerfile` 且（如果有使用到容器集群编排）还有需要修改 `docker-compose.yml` 。相关参考资料可以查看 Docker 官方文档 [EXPOSE in the Dockerfile reference](https://docs.docker.com/engine/reference/builder/#expose) 以及 [networking in Compose](https://docs.docker.com/compose/networking/)。

6
README.md
View File

@ -2,7 +2,7 @@
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
Language English | [中文](/README-zhCN.md) | [한국어](/README_koKR.md)
Language English | [中文](/README-zhCN.md) | [한국어](/README-koKR.md)
This repository provides an API that can be used to handle events on your community server(s) and manipulate them.
@ -26,8 +26,12 @@ The easiest way to get started with all of this, is to use `Program.cs` and add
This project can either be built by using [`dotnet build`](https://learn.microsoft.com/en-us/dotnet/core/tools/dotnet-build) on the command-line or by using the run / build options inside your preferred IDE.
Alternatively, you can use Docker to run it. An easy way to do this it to run `docker compose up`.
### Connecting to the gameserver(s)
After writing and compiling this project. You will want to host it somewhere. This could be on the same server that the gameservers run on, or somewhere completely different. We do recommend to keep the latency to the gameserver minimal for smoother and faster communication. The same `ServerListener` can be used for *multiple* gameservers at the same time. You can specify the API server (address & port) in the launch options of the gameserver.
The gameserver connects to the API with the launch argument `"-apiendpoint=<IP>:<port>"`, where `<port>` is the port that the listener listens on and the `<IP>` is the IP of the API server.
The project is currently configured to have the API listen on port `29294`. If you want to change this, make sure to change it in the code (on your `listener.start(port)`). Port `29294` is also exposed in Docker and bound to the same port on the host in Docker Compose. This means that when using Docker, you will have to change the port in the `Dockerfile` and in `docker-compose.yml` (when using Compose) as well. See [EXPOSE in the Dockerfile reference](https://docs.docker.com/engine/reference/builder/#expose) and [networking in Compose](https://docs.docker.com/compose/networking/).