ModernUO/Projects/Server/PropertyList/IPropertyList.cs
Kamron Batman c94084b48f fix(opl): cap per-property length + chunk OplTextBlock to avoid legacy 2D-client crash
The legacy 2D (EA) client copies each OPL property's argument into a fixed ~512-char
(1024-byte) buffer; a single property that exceeds it overruns the heap and crashes the
client. OplTextBlock previously emitted one entry regardless of length.

- ObjectPropertyList.MaxArgumentLength (504 chars, under the ~510 ceiling).
- ClampArgument backstop in both InternalAdd paths (span + interpolation): truncates an
  oversized argument and logs the offending entity/cliloc.
- AddChunked(ReadOnlySpan<char>): splits newline-joined text across multiple cycling
  passthrough properties, breaking only at '\n', so none exceeds the cap.
- OplTextBlock.Dispose emits via AddChunked; AddChunked added to IPropertyList.
2026-06-26 00:45:51 -07:00

53 lines
2.3 KiB
C#

/*************************************************************************
* ModernUO *
* Copyright 2019-2026 - ModernUO Development Team *
* Email: hi@modernuo.com *
* File: IPropertyList.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 <http://www.gnu.org/licenses/>. *
*************************************************************************/
using System;
using System.Runtime.CompilerServices;
using Server.Text;
namespace Server;
public interface IPropertyList : ISelfInterpolatedStringHandler
{
public void Reset();
public void Terminate();
public void Add(int number);
/** Convenience method for $"{argument}". */
public void Add(int number, string argument);
/** Convenience method for span-based text without allocating a string. */
public void Add(ReadOnlySpan<char> argument);
/** Convenience method for span-based text without allocating a string. */
public void Add(int number, ReadOnlySpan<char> argument);
/** Emits newline-joined text across multiple properties so none exceeds the legacy client's per-property buffer. */
public void AddChunked(ReadOnlySpan<char> text);
/** Convenience method for $"{value}". */
public void Add(int number, int value);
/** Convenience method for $"{value:#}". */
public void AddLocalized(int value);
/** Convenience method for $"{value:#}". */
public void AddLocalized(int number, int value);
// String Interpolation
public void Add([InterpolatedStringHandlerArgument("")] ref InterpolatedStringHandler handler);
public void Add(int number, [InterpolatedStringHandlerArgument("")] ref InterpolatedStringHandler handler);
}