Forums

The clock posts are stamped with (a seam so tests control time).

• long UtcNowMs { get; }

  Now, unix ms UTC.

Where threads and posts are kept. The default is in memory; persistence composes a document-backed one.

• void DeleteBoard(string key)

  Removes a named board's record (its threads are deleted by the caller).

• void DeleteThread(long threadId)

  Deletes a thread and all its posts.

• IReadOnlyDictionary<long, long> LastReads(long accountId)

  One account's read markers: thread id to the newest post id it has read.

• IReadOnlyList<ForumBoardRecord> LoadBoards()

  Every named board.

• IReadOnlyList<ForumPostRecord> LoadPosts(long threadId)

  A thread's posts, oldest first.

• IReadOnlyList<ForumThreadRecord> LoadThreads()

  Every thread header.

• long NextId(bool thread)

  The next thread or post id (one sequence each).

• void SaveBoard(ForumBoardRecord board)

  Saves (adds or replaces) a named board.

• void SavePost(ForumPostRecord post)

  Saves (adds or replaces) a post.

• void SaveThread(ForumThreadRecord thread)

  Saves (adds or replaces) a thread header.

• void SetLastRead(long accountId, long threadId, long postId)

  Sets an account's read marker for a thread.

Forums: boards (game-defined keys) of threads of posts. Who may read, post and moderate is the game's IForumAccess; everything is bounded by ForumOptions and durable through IForumStore. Nothing is pushed: clients pull pages, and Posted lets the game tell its players (a reply flag, a mail, a badge).

• long Announce(string board, long authorAccountId, string title, string body)

  Server-side: starts a thread as authorAccountId (an announcement), skipping access, prefixes and the cooldown but not the size limits. Returns the thread id (0 = refused).

• bool CreateBoard(string key, string title)

  Creates or retitles a named board as the server (no access check, no cap). Defaulted (rule 25).

• bool DeleteBoard(string key)

  Deletes a board and every thread on it, as the server. Defaulted (rule 25).

• bool DeleteThread(long threadId)

  Server-side: deletes a thread and its posts.

• event Action<string, long, long, long> Posted

  Raised after a thread is started or a reply posted: (board, thread, post, author).

• ForumThreadRecord Thread(long threadId)

  A thread header, or null.

Forums tuning (defaults here; never inlined in logic). Bound from Crossplay:Forums.

• char BoardParentSeparator { get; set; }

  A board key's parent is everything up to and including its last occurrence of this character ("guild:12:trade" -> "guild:12:"). Named-board caps count boards under the same parent.

• List<string> BoardPrefixes { get; set; }

  Board keys a client may use must start with one of these (ordinal). Empty = any key the game's access rule allows. A board exists from its first thread.

• double EditWindowSeconds { get; set; }

  How long after posting its author may edit it, in seconds. 0 = posts cannot be edited.

• int MaxBoardKeyLength { get; set; }

  Longest board key, in characters.

• int MaxBoardTitleLength { get; set; }

  Longest named-board title, in characters.

• int MaxBoards { get; set; }

  Most boards that may exist at once (a new board's first thread is refused past this).

• int MaxBodyLength { get; set; }

  Longest post, in characters.

• int MaxNamedBoardsPerParent { get; set; }

  Most named boards under one parent key (see BoardParentSeparator), unless the access rule says otherwise.

• int MaxPostsPerThread { get; set; }

  Most posts one thread may hold (a full thread takes no more replies).

• int MaxThreadsPerBoard { get; set; }

  Most threads one board may hold.

• int MaxTitleLength { get; set; }

  Longest thread title, in characters.

• int MaxUnreadThreads { get; set; }

  Most threads one unread-count request may ask about; the rest of the request is ignored.

• double PostCooldownSeconds { get; set; }

  Least time between two posts (threads or replies) by one account, in seconds. 0 = no limit.

• int PostPageSize { get; set; }

  Posts per ForumPostsRequest page.

• int ThreadPageSize { get; set; }

  Threads per ForumThreadsRequest page.

Client SDK for Forums: every verb is one awaitable call (Core's request/reply helper - a call that gets no answer completes as a timeout, it never throws). Boards are game-defined keys; who may read, post and moderate is the server's rule. Nothing is pushed - pull a page when the player opens a board. Pure SDK, no UI.

• UniTask<ForumThreads> ThreadsAsync(string board, int skip = 0, CancellationToken ct = default)

  A page of a board's threads (pinned first, then most recently active).

• UniTask<ForumPosts> PostsAsync(long threadId, long afterPostId = 0, CancellationToken ct = default)

  A page of a thread's posts after afterPostId, oldest first.

• UniTask<ForumResult> CreateThreadAsync(string board, string title, string body, CancellationToken ct = default)

  Starts a thread.

• UniTask<ForumResult> ReplyAsync(long threadId, string body, CancellationToken ct = default)

  Replies in a thread.

• UniTask<ForumResult> EditAsync(long threadId, long postId, string body, CancellationToken ct = default)

  Edits my post (within the server's edit window).

• UniTask<ForumResult> DeleteAsync(long threadId, long postId, CancellationToken ct = default)

  Deletes a post (mine, or any as a moderator).

• UniTask<ForumResult> ModerateAsync(long threadId, byte action, CancellationToken ct = default)

  (Moderator) pins, unpins, locks, unlocks or deletes a thread - see ForumModeration.

• UniTask<ForumBoards> BoardsAsync(string prefix, CancellationToken ct = default)

  The boards under a key prefix I may read (named ones with titles, and ones with threads). Defaulted so an existing implementation of this interface still compiles (rule 25).

• UniTask<ForumResult> CreateBoardAsync(string key, string title, CancellationToken ct = default)

  Creates or retitles a named board (its managers). Defaulted (rule 25).

• UniTask<ForumResult> DeleteBoardAsync(string key, CancellationToken ct = default)

  Deletes a board and its threads (its managers). Defaulted (rule 25).

• UniTask<ForumThreadPage> ThreadPageAsync(string board, int skip = 0, CancellationToken ct = default)

  A page of a board's threads with author names and my unread marks. Defaulted (rule 25).

• UniTask<ForumPostPage> PostPageAsync(long threadId, long afterPostId = 0, CancellationToken ct = default)

  A page of a thread's posts with author names; fetching marks them read. Defaulted (rule 25).

• UniTask<ForumUnread> UnreadAsync(long[] threadIds, CancellationToken ct = default)

  My unread post count in each of these threads, in one request (a badge per tab). Opening a thread with PostPageAsync clears its count. Defaulted (rule 25).