Package edu.uky.cs.nil.tt

package edu.uky.cs.nil.tt

Tandem Tales is a platform that enables short, paired storytelling exercises between two agents over a network.

This package defines the essential elements of Tandem Tales, including the server that listens for connections and matches compatible pairs of clients. The server maintains a database of which story worlds and agent types are publicly and privately available.

Related Packages

Package	Description
edu.uky.cs.nil.tt.io	The IO (input/output) package defines the various message types that can be sent between a server and client and provide some utilities for serializing and deserializing objects as JSON.
edu.uky.cs.nil.tt.world	Story worlds define the objects, concepts, and actions that exist in a story, and story world models define the logic for when actions can happen, how actions change the current state of world, when endings happen, etc.

Class	Description
Agent	An agent represents an individual connection to a server that can server as one of the roles in a session.
Arguments	A list of command line arguments and various utility methods to parse keys and values.
Client	A client connects to a server to find a partner and play a role in a storytelling session.
ClientFactory	A client factory creates continuously creates clients to connect to a server and is useful for deploying automated agents.
ClockThread	The clock thread regularly calls the server's tick method.
CommandParser	A command parser listens (on standard input) for and executes simple text commands, like modifying the server's database and shutting the server down.
CommandParser.Command	A command is a type of operation that can be parsed by a command parser and executed on a server.
CommandParser.Operation	An operation represents a single command that can be executed on a server based on a series of arguments that define how it behaves.
Database	A database is a server's persistent store of information about the story worlds and agents available for sessions.
Database.AgentEntry	A database entry for an agent.
Database.Entry	A database entry represents an individual elements in the database, including its meta-data, such as its title and description.
Database.Listable	A listable entry is one that can either be set as clearly publicly available (listed) or not clearly available (unlisted).
Database.WorldEntry	A database entry for a story world.
Log	A log is used to record system messages and session data.
Named	A named object has a unique name that specifically distinguishes it from other objects of the same type in the same context.
Role	Represents the two roles in a collaborative storytelling session: the Player, who typically controls a single character, and the Game Master, who controls all other characters and the environment.
Server	The server listens for new connections from the network, reports which story worlds and agent types it supports, and makes matches between agents so they can collaborate in storytelling sessions.
ServerMain	The main entry point for the Tandem Tales server.
Session	A session records the events of a story, any reports of the story's quality, and the final result at the end of a storytelling exercise between a player and game master.
Session.Event	An event represents a single turn during a storytelling session as well as the actual state of the story world after the turn and the state of the world as perceived by the player.
Session.Report	A report occurs when one participant in a session sends their response to a question about the narrative.
Session.Result	A result explains how the session ended.
Session.Timestamped	A timestamped object records the moment at which it was created.
Settings	Constants and other project-wide settings.
Test
Test.RandomClient
TutorialWorldFactory	A example of how to create a logical story world model.
Utilities	A collection of utility methods used throughout this project.