squidpony

Class MonsterGen.Chimera

java.lang.Object

squidpony.MonsterGen.Chimera

Enclosing class:

MonsterGen

public static class MonsterGen.Chimera
extends java.lang.Object

A creature that can be mixed with other Chimeras or given additional descriptors, then printed in a usable format for game text.

Field Summary

Fields

Modifier and Type	Field and Description
java.lang.String	mainForm
java.lang.String	name
OrderedMap<java.lang.String,java.util.List<java.lang.String>>	parts
OrderedSet<java.lang.String>	powerAdjectives
OrderedSet<java.lang.String>	powerPhrases
java.lang.String	unknown
OrderedSet<java.lang.String>	unsaidAdjectives
OrderedSet<java.lang.String>	wholeAdjectives

Constructor Summary

Constructors

Constructor and Description
Chimera(java.lang.String name, MonsterGen.Chimera other) Copies an existing Chimera other into a new Chimera with potentially a different name.
Chimera(java.lang.String name, java.lang.String unknown, java.util.Collection<java.lang.String> parts, java.util.Collection<java.lang.String> unsaid, java.util.Collection<java.lang.String> whole, java.util.Collection<java.lang.String> powerAdj, java.util.Collection<java.lang.String> powerPhr) Constructs a Chimera given a name (typically all lower-case), null if the creature is familiar or a String if the creature's basic shape is likely to be unknown to players, and several String Collection args for the different aspects of the Chimera.
Chimera(java.lang.String name, java.lang.String unknown, java.lang.String... terms) Constructs a Chimera given a name (typically all lower-case), null if the creature is familiar or a String if the creature's basic shape is likely to be unknown to players, and an array or vararg of String terms containing, usually, several groups of String elements separated by the literal string ";" .

Method Summary

Modifier and Type	Method and Description
MonsterGen.Chimera	mix(RNG rng, java.lang.String newName, MonsterGen.Chimera other, double otherInfluence) Fuse two Chimera objects by some fraction of influence, using the given RNG and possibly renaming the creature.
MonsterGen.Chimera	mix(java.lang.String newName, MonsterGen.Chimera other, double otherInfluence) Fuse two Chimera objects by some fraction of influence, using the default RNG and possibly renaming the creature.
java.lang.String	present(boolean capitalize) Get a string description of this monster's appearance and powers.
java.lang.String	presentVisible(boolean capitalize) Get a string description of this monster's appearance.
java.lang.String	toString()

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Field Detail

parts

public OrderedMap<java.lang.String,java.util.List<java.lang.String>> parts

unsaidAdjectives

public OrderedSet<java.lang.String> unsaidAdjectives

wholeAdjectives

public OrderedSet<java.lang.String> wholeAdjectives

powerAdjectives

public OrderedSet<java.lang.String> powerAdjectives

powerPhrases

public OrderedSet<java.lang.String> powerPhrases

name

public java.lang.String name

mainForm

public java.lang.String mainForm

unknown

public java.lang.String unknown

Constructor Detail

Chimera

public Chimera(java.lang.String name,
               MonsterGen.Chimera other)

Copies an existing Chimera other into a new Chimera with potentially a different name.

Parameters:

name - the name to use for the Chimera this constructs

other - the existing Chimera to copy all fields but name from.

Chimera

public Chimera(java.lang.String name,
               java.lang.String unknown,
               java.lang.String... terms)

Constructs a Chimera given a name (typically all lower-case), null if the creature is familiar or a String if the creature's basic shape is likely to be unknown to players, and an array or vararg of String terms containing, usually, several groups of String elements separated by the literal string ";" . The first group in terms contains what body parts this creature has and could potentially grant to another creature if mixed; examples are "head", "legs", "claws", "wings", and "eyes". In the next group are the "unsaid" adjectives, which are not listed if unknown is false, but may be contributed to other creatures if mixed (mixing a horse with a snake may make the horse scaly, since "scaly" is an unsaid adjective for snakes). Next are adjectives that apply to the whole creature's appearance, which don't need to replicate the unsaid adjectives and are often added as a step to randomize a creature; this part is often empty and simply ends on the separator ";" . Next are the power adjectives, which are any special abilities a creature might have that aren't immediately visible, like "furious" or "toxic". Last are the power phrases, which follow a format like "can cast arcane spells", "embodies the wilderness", or "constantly drools acid"; it should be able to be put in a sentence after the word "that", like "a snake that can cast arcane spells".
The unknown argument determines if descriptions need to include basic properties like calling a Snake scaly (null in this case) or a Pestilence Fiend chitinous (no one knows what that creature is, so a String needs to be given so a player and player character that don't know its name can call it something, like "demon").
An example is Chimera SNAKE = new Chimera("snake", null, "head", "tail", "fangs", "eyes", ";", "reptilian", "scaly", "lean", "curvaceous", ";", ";", "toxic");

Parameters:

name - the name to refer to the creature by and its body parts by when mixed

unknown - true if the creature's basic shape is unlikely to be known by a player, false for animals and possibly common mythological creatures like dragons

terms - an array or vararg of String elements, separated by ";" , see method documentation for details

Chimera

public Chimera(java.lang.String name,
               java.lang.String unknown,
               java.util.Collection<java.lang.String> parts,
               java.util.Collection<java.lang.String> unsaid,
               java.util.Collection<java.lang.String> whole,
               java.util.Collection<java.lang.String> powerAdj,
               java.util.Collection<java.lang.String> powerPhr)

Constructs a Chimera given a name (typically all lower-case), null if the creature is familiar or a String if the creature's basic shape is likely to be unknown to players, and several String Collection args for the different aspects of the Chimera. The first Collection contains what body parts this creature has and could potentially grant to another creature if mixed; examples are "head", "legs", "claws", "wings", and "eyes". The next Collection contains "unsaid" adjectives, which are not listed if unknown is false, but may be contributed to other creatures if mixed (mixing a horse with a snake may make the horse scaly, since "scaly" is an unsaid adjective for snakes). Next are adjectives that apply to the "whole" creature's appearance, which don't need to replicate the unsaid adjectives and are often added as a step to randomize a creature; this Collection is often empty. Next are the power adjectives, which are any special abilities a creature might have that aren't immediately visible, like "furious" or "toxic". Last are the power phrases, which follow a format like "can cast arcane spells", "embodies the wilderness", or "constantly drools acid"; it should be able to be put in a sentence after the word "that", like "a snake that can cast arcane spells".
The unknown argument determines if descriptions need to include basic properties like calling a Snake scaly (null in this case) or a Pestilence Fiend chitinous (no one knows what that creature is, so a String needs to be given so a player and player character that don't know its name can call it something, like "demon").
An example is Chimera SNAKE = new Chimera("snake", null, "head", "tail", "fangs", "eyes", ";", "reptilian", "scaly", "lean", "curvaceous", ";", ";", "toxic");

Parameters:

name - the name to refer to the creature by and its body parts by when mixed

unknown - true if the creature's basic shape is unlikely to be known by a player, false for animals and possibly common mythological creatures like dragons

parts - the different body part nouns this creature can contribute to a creature when mixed

unsaid - appearance adjectives that don't need to be said if the creature is familiar

whole - appearance adjectives that apply to the whole creature

powerAdj - power adjectives like "furious" or "fire-breathing"

powerPhr - power phrases like "can cast arcane spells"

Method Detail

present

public java.lang.String present(boolean capitalize)

Get a string description of this monster's appearance and powers.

Parameters:

capitalize - true if the description should start with a capital letter.

Returns:

a String description including both appearance and powers

presentVisible

public java.lang.String presentVisible(boolean capitalize)

Get a string description of this monster's appearance.

Parameters:

capitalize - true if the description should start with a capital letter.

Returns:

a String description including only the monster's appearance

toString

public java.lang.String toString()

Overrides:

toString in class java.lang.Object

mix

public MonsterGen.Chimera mix(RNG rng,
                              java.lang.String newName,
                              MonsterGen.Chimera other,
                              double otherInfluence)

Fuse two Chimera objects by some fraction of influence, using the given RNG and possibly renaming the creature. Does not modify the existing Chimera objects.

Parameters:

rng - the RNG to determine random factors

newName - the name to call the produced Chimera

other - the Chimera to mix with this one

otherInfluence - the fraction between 0.0 and 1.0 of descriptors from other to use

Returns:

a new Chimera mixing features from both inputs

mix

public MonsterGen.Chimera mix(java.lang.String newName,
                              MonsterGen.Chimera other,
                              double otherInfluence)

Fuse two Chimera objects by some fraction of influence, using the default RNG and possibly renaming the creature. Does not modify the existing Chimera objects.

Parameters:

newName - the name to call the produced Chimera

other - the Chimera to mix with this one

otherInfluence - the fraction between 0.0 and 1.0 of descriptors from other to use

Returns:

a new Chimera mixing features from both inputs