/*************************************************************************
* ModernUO *
* Copyright 2019-2026 - ModernUO Development Team *
* Email: hi@modernuo.com *
* File: BanConfiguration.cs *
* *
* This program is free software: you can redistribute it and/or modify *
* it under the terms of the GNU General Public License as published by *
* the Free Software Foundation, either version 3 of the License, or *
* (at your option) any later version. *
* *
* You should have received a copy of the GNU General Public License *
* along with this program. If not, see . *
*************************************************************************/
using System;
using System.IO;
using System.Text.Json.Serialization;
using Server.Json;
namespace Server.Network.Bans;
///
/// Loads the from Configuration/bans.json (matching the per-feature
/// JSON config pattern used by AssistantConfiguration). Loaded once; a missing file writes a
/// local-only, fail-open template so operators have something to edit.
///
public static class BanConfiguration
{
private const string _path = "Configuration/bans.json";
public static BanSettings Settings { get; private set; }
public static void Configure()
{
// Idempotent: this Configure() is auto-discovered and also called explicitly by BanChannel,
// so guard against a redundant second load.
if (Settings != null)
{
return;
}
var path = Path.Join(Core.BaseDirectory, _path);
if (File.Exists(path))
{
Settings = JsonConfig.Deserialize(path);
}
else
{
Settings = new BanSettings
{
ReportRateLimitTrips = true,
AutoBanDuration = TimeSpan.FromHours(4)
};
Save();
}
}
private static void Save()
{
JsonConfig.Serialize(Path.Join(Core.BaseDirectory, _path), Settings);
}
}
/// Ban-channel policy: which reporters receive contributions, and how auto-detections are handled.
public record BanSettings
{
/// Whether IP rate-limiter trips are contributed to reporters. They never enter the local firewall set.
[JsonPropertyName("reportRateLimitTrips")]
public bool ReportRateLimitTrips { get; set; } = true;
/// Duration reported for an auto-detected (rate-limit) ban.
[JsonPropertyName("autoBanDuration")]
public TimeSpan AutoBanDuration { get; set; } = TimeSpan.FromHours(4);
/// Path to the local blocklist file, relative to .
[JsonPropertyName("blocklistFile")]
public string BlocklistFile { get; set; } = "";
/// How often the blocklist file is re-read for changes.
[JsonPropertyName("blocklistReloadInterval")]
public TimeSpan BlocklistReloadInterval { get; set; } = TimeSpan.FromSeconds(60);
/// Whether blocklist hits are contributed to reporters.
[JsonPropertyName("reportBlocklistHits")]
public bool ReportBlocklistHits { get; set; } = true;
/// Duration reported for a blocklist-matched ban.
[JsonPropertyName("blocklistBanDuration")]
public TimeSpan BlocklistBanDuration { get; set; } = TimeSpan.FromHours(6);
///
/// How long the accept-path guard suppresses re-reporting a promoted IP. This only needs to bridge
/// the gap until the OS bouncer picks up the promotion (seconds); after that the kernel drops repeat
/// traffic. Decoupled from so the guard doesn't remember hours of
/// distinct IPs.
///
[JsonPropertyName("blocklistPromoteSuppression")]
public TimeSpan BlocklistPromoteSuppression { get; set; } = TimeSpan.FromSeconds(60);
}