Codifying Character Logic in Role-Playing

Letian Peng, Jingbo Shang
5/12/2025
cs.CL

No official code found. Best implementation: KomeijiForce/Codified_Profile_Koishiday_2025 (24 stars, last commit 2026-01-15).

Abstract

This paper introduces Codified Profiles for role-playing, a novel approach that represents character logic as structured, executable functions for behavioral decision-making. Each profile defines a set of functions parse_by_scene(scene) that outputs a list of logic-grounded assertions triggered_statements, using both explicit control structures (e.g., if-then-else) and condition checks like check_condition(scene, question), where each question is a semantically meaningful prompt about the scene (e.g., "Is the character in danger?") discriminated by the role-playing LLM as true, false, or unknown. This explicit representation offers three key advantages over traditional prompt-based profiles, which append character descriptions directly into text prompts: (1) Persistence, by enforcing complete and consistent execution of character logic, rather than relying on the model's implicit reasoning; (2) Updatability, through systematic inspection and revision of behavioral logic, which is difficult to track or debug in prompt-only approaches; (3) Controllable Randomness, by supporting stochastic behavior directly within the logic, enabling fine-grained variability that prompting alone struggles to achieve. To validate these advantages, we introduce a new benchmark constructed from 83 characters and 5,141 scenes curated from Fandom, using NLI-based scoring to compare character responses against ground-truth actions. Our experiments demonstrate the significant benefits of codified profiles in improving persistence, updatability, and behavioral diversity. Notably, by offloading a significant portion of reasoning to preprocessing, codified profiles enable even 1B-parameter models to perform high-quality role-playing, providing a scalable and efficient foundation for local deployment of role-play agents.

View on arXivView PDF

Code Implementations(1)

Koishi's Day 2025 Paper (NeurIPS 2025): "Codifying Character Logic in Role-Playing"

240Shell, PythonMay 13, 20259 months ago

Cite this paper

@article{peng2025codifying,
  title  = {Codifying Character Logic in Role-Playing},
  author = {Letian Peng and Jingbo Shang},
  year   = {2025},
  eprint = {2505.07705},
  archivePrefix = {arXiv},
  url    = {http://arxiv.org/abs/2505.07705v2}
}

Add a badge to your README

Shows whether official code is linked for this paper.

Code of Paper badge
[![Code of Paper](https://codeofpaper.com/badge/2505.07705.svg)](https://codeofpaper.com/paper/2505.07705)

Discussion