TShock/TShockAPI/Configuration/ServerSideConfig.cs
Lucas Nicodemus 68ae73ffef Warn players if bypass SSC permission is enabled
If a player has the tshock.ignore.ssc permission, odds are that they may
want to know that their data isn't being saved or not. This change
allows users to be notified if they have SSC data stored in the DB but
they aren't having it loaded due to the aforementioned permission.

This permission causes great confusion, but we can't really change it
because we would break existing setups. This is an easy change that
gives people a reason why they suddenly "have no items."

This new option can be turned off in the config file for SSC if it's not
desired.

This change also modifies some of the log messages so that it's clear
why the SSC save didn't occur for a given player.
2021-05-21 01:16:04 -07:00

114 lines
3.9 KiB
C#
Raw Blame History

This file contains invisible Unicode characters

This file contains invisible Unicode characters that are indistinguishable to humans but may be processed differently by a computer. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

/*
TShock, a server mod for Terraria
Copyright (C) 2011-2019 Pryaxis & TShock Contributors
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.
This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.
You should have received a copy of the GNU General Public License
along with this program. If not, see <http://www.gnu.org/licenses/>.
*/
using System;
using System.Collections.Generic;
using System.ComponentModel;
using System.IO;
using System.Linq;
using System.Text;
using Newtonsoft.Json;
namespace TShockAPI.Configuration
{
/// <summary>
/// Settings used to configure server side characters
/// </summary>
public class SscSettings
{
/// <summary>
/// Enable server side characters, causing client data to be saved on the server instead of the client.
/// </summary>
[Description("Enable server side characters, causing client data to be saved on the server instead of the client.")]
public bool Enabled = false;
/// <summary>
/// How often SSC should save, in minutes.
/// </summary>
[Description("How often SSC should save, in minutes.")]
public int ServerSideCharacterSave = 5;
/// <summary>
/// Time, in milliseconds, to disallow discarding items after logging in when ServerSideCharacters is ON.
/// </summary>
[Description("Time, in milliseconds, to disallow discarding items after logging in when ServerSideCharacters is ON.")]
public int LogonDiscardThreshold = 250;
/// <summary>
/// The starting default health for new players when SSC is enabled.
/// </summary>
[Description("The starting default health for new players when SSC is enabled.")]
public int StartingHealth = 100;
/// <summary>
/// The starting default mana for new players when SSC is enabled.
/// </summary>
[Description("The starting default mana for new players when SSC is enabled.")]
public int StartingMana = 20;
/// <summary>
/// The starting default inventory for new players when SSC is enabled.
/// </summary>
[Description("The starting default inventory for new players when SSC is enabled.")]
public List<NetItem> StartingInventory = new List<NetItem>();
/// <summary>
/// Warns players that they have the bypass SSC permission enabled. To disable warning, turn this off.
/// </summary>
[Description("Warns players and the console if a player has the tshock.ignore.ssc permission with data in the SSC table.")]
public bool WarnPlayersAboutBypassPermission = true;
}
/// <summary>
/// Configuration for the server side characters system
/// </summary>
public class ServerSideConfig : ConfigFile<SscSettings>
{
/// <summary>
/// Dumps all configuration options to a text file in Markdown format
/// </summary>
public static void DumpDescriptions()
{
var sb = new StringBuilder();
var defaults = new ServerSideConfig();
foreach (var field in defaults.GetType().GetFields().OrderBy(f => f.Name))
{
if (field.IsStatic)
continue;
var name = field.Name;
var type = field.FieldType.Name;
var descattr =
field.GetCustomAttributes(false).FirstOrDefault(o => o is DescriptionAttribute) as DescriptionAttribute;
var desc = descattr != null && !string.IsNullOrWhiteSpace(descattr.Description) ? descattr.Description : "None";
var def = field.GetValue(defaults);
sb.AppendLine("{0} ".SFormat(name));
sb.AppendLine("Type: {0} ".SFormat(type));
sb.AppendLine("Description: {0} ".SFormat(desc));
sb.AppendLine("Default: \"{0}\" ".SFormat(def));
sb.AppendLine();
}
File.WriteAllText("ServerSideConfigDescriptions.txt", sb.ToString());
}
}
}