Files
wwdpublic/Content.Server/Language/Commands/AdminTranslatorCommand.cs
Mnemotechnican 81ad859c46 Admeme Language Commands (Attempt 2) (#565)
# Description
#562 but using commands instead of tricks.

Less user-friendly but makes you look like a hacker when you use them
:trollface:


<details><summary><h1>Media</h1></summary><p>


![image](https://github.com/user-attachments/assets/818b6226-aea8-4f9a-b30d-5df39b8041e6)

![image](https://github.com/user-attachments/assets/f3c40feb-f84d-4083-bc9a-44f7b1dfb30d)

![image](https://github.com/user-attachments/assets/31827207-4903-4df1-9074-eb060d0cf63c)

(ignore the missing locale, I fixes)

</p></details>

# Changelog

🆑
- add: Admin tooling: added several admin commands to help manipulate
entities' languages.

---------

Signed-off-by: Mnemotechnican <69920617+Mnemotechnician@users.noreply.github.com>
Co-authored-by: DEATHB4DEFEAT <77995199+DEATHB4DEFEAT@users.noreply.github.com>
2024-08-06 17:22:11 -04:00

156 lines
5.7 KiB
C#

using System.Diagnostics.CodeAnalysis;
using Content.Server.Administration;
using Content.Shared.Administration;
using Content.Shared.Language;
using Content.Shared.Language.Components;
using Content.Shared.Language.Components.Translators;
using Content.Shared.Language.Systems;
using Robust.Server.Containers;
using Robust.Shared.Toolshed;
using Robust.Shared.Toolshed.Syntax;
using Robust.Shared.Toolshed.TypeParsers;
namespace Content.Server.Language.Commands;
[ToolshedCommand(Name = "translator"), AdminCommand(AdminFlags.Admin)]
public sealed class AdminTranslatorCommand : ToolshedCommand
{
private LanguageSystem? _languagesField;
private ContainerSystem? _containersField;
private ContainerSystem Containers => _containersField ??= GetSys<ContainerSystem>();
private LanguageSystem Languages => _languagesField ??= GetSys<LanguageSystem>();
[CommandImplementation("addlang")]
public EntityUid AddLanguage(
[CommandInvocationContext] IInvocationContext ctx,
[PipedArgument] EntityUid input,
[CommandArgument] ValueRef<string, Prototype<LanguagePrototype>> @ref,
[CommandArgument] bool addSpeak = true,
[CommandArgument] bool addUnderstand = true
)
{
var language = @ref.Evaluate(ctx)!;
// noob trap - needs a universallanguagespeakercomponent
if (language == SharedLanguageSystem.UniversalPrototype)
throw new ArgumentException(Loc.GetString("command-language-error-this-will-not-work"));
if (!TryGetTranslatorComp(input, out var translator))
throw new ArgumentException(Loc.GetString("command-language-error-not-a-translator", ("entity", input)));
if (addSpeak && !translator.SpokenLanguages.Contains(language))
translator.SpokenLanguages.Add(language);
if (addUnderstand && !translator.UnderstoodLanguages.Contains(language))
translator.UnderstoodLanguages.Add(language);
UpdateTranslatorHolder(input);
return input;
}
[CommandImplementation("rmlang")]
public EntityUid RemoveLanguage(
[CommandInvocationContext] IInvocationContext ctx,
[PipedArgument] EntityUid input,
[CommandArgument] ValueRef<string, Prototype<LanguagePrototype>> @ref,
[CommandArgument] bool removeSpeak = true,
[CommandArgument] bool removeUnderstand = true
)
{
var language = @ref.Evaluate(ctx)!;
if (!TryGetTranslatorComp(input, out var translator))
throw new ArgumentException(Loc.GetString("command-language-error-not-a-translator", ("entity", input)));
if (removeSpeak)
translator.SpokenLanguages.Remove(language);
if (removeUnderstand)
translator.UnderstoodLanguages.Remove(language);
UpdateTranslatorHolder(input);
return input;
}
[CommandImplementation("addrequired")]
public EntityUid AddRequiredLanguage(
[CommandInvocationContext] IInvocationContext ctx,
[PipedArgument] EntityUid input,
[CommandArgument] ValueRef<string, Prototype<LanguagePrototype>> @ref)
{
var language = @ref.Evaluate(ctx)!;
if (!TryGetTranslatorComp(input, out var translator))
throw new ArgumentException(Loc.GetString("command-language-error-not-a-translator", ("entity", input)));
if (!translator.RequiredLanguages.Contains(language))
{
translator.RequiredLanguages.Add(language);
UpdateTranslatorHolder(input);
}
return input;
}
[CommandImplementation("rmrequired")]
public EntityUid RemoveRequiredLanguage(
[CommandInvocationContext] IInvocationContext ctx,
[PipedArgument] EntityUid input,
[CommandArgument] ValueRef<string, Prototype<LanguagePrototype>> @ref)
{
var language = @ref.Evaluate(ctx)!;
if (!TryGetTranslatorComp(input, out var translator))
throw new ArgumentException(Loc.GetString("command-language-error-not-a-translator", ("entity", input)));
if (translator.RequiredLanguages.Remove(language))
UpdateTranslatorHolder(input);
return input;
}
[CommandImplementation("lsspoken")]
public IEnumerable<string> ListSpoken([PipedArgument] EntityUid input)
{
if (!TryGetTranslatorComp(input, out var translator))
return [];
return translator.SpokenLanguages;
}
[CommandImplementation("lsunderstood")]
public IEnumerable<string> ListUnderstood([PipedArgument] EntityUid input)
{
if (!TryGetTranslatorComp(input, out var translator))
return [];
return translator.UnderstoodLanguages;
}
[CommandImplementation("lsrequired")]
public IEnumerable<string> ListRequired([PipedArgument] EntityUid input)
{
if (!TryGetTranslatorComp(input, out var translator))
return [];
return translator.RequiredLanguages;
}
private bool TryGetTranslatorComp(EntityUid uid, [NotNullWhen(true)] out BaseTranslatorComponent? translator)
{
if (TryComp<HandheldTranslatorComponent>(uid, out var handheld))
translator = handheld;
else if (TryComp<TranslatorImplantComponent>(uid, out var implant))
translator = implant;
else if (TryComp<IntrinsicTranslatorComponent>(uid, out var intrinsic))
translator = intrinsic;
else
translator = null;
return translator != null;
}
private void UpdateTranslatorHolder(EntityUid translator)
{
if (!Containers.TryGetContainingContainer(translator, out var cont)
|| cont.Owner is not { Valid: true } holder)
return;
Languages.UpdateEntityLanguages(holder);
}
}