Game.LambdaHack.Server.ItemRev

Creation of items on the server. Types and operations that don't involve server state nor our custom monads.

Documentation

data ItemKnown

The essential item properties, used for the ItemRev hash table from items to their ids, needed to assign ids to newly generated items. All the other meaningful properties can be derived from them. Note: item seed instead of AspectRecord is not enough, becaused different seeds may result in the same AspectRecord and we don't want such items to be distinct in UI and elsewhere.

Constructors

ItemKnown ItemIdentity AspectRecord (Maybe FactionId)

Instances

Eq ItemKnown

Defined in Game.LambdaHack.Server.ItemRev

Methods

(==) :: ItemKnown -> ItemKnown -> Bool

(/=) :: ItemKnown -> ItemKnown -> Bool

Show ItemKnown

Defined in Game.LambdaHack.Server.ItemRev

Methods

showsPrec :: Int -> ItemKnown -> ShowS

show :: ItemKnown -> String

showList :: [ItemKnown] -> ShowS

Generic ItemKnown

Defined in Game.LambdaHack.Server.ItemRev

Associated Types

type Rep ItemKnown :: Type -> Type

Methods

from :: ItemKnown -> Rep ItemKnown x

to :: Rep ItemKnown x -> ItemKnown

Binary ItemKnown

Defined in Game.LambdaHack.Server.ItemRev

Methods

put :: ItemKnown -> Put

get :: Get ItemKnown

putList :: [ItemKnown] -> Put

Hashable ItemKnown

Defined in Game.LambdaHack.Server.ItemRev

Methods

hashWithSalt :: Int -> ItemKnown -> Int

hash :: ItemKnown -> Int

type Rep ItemKnown

Defined in Game.LambdaHack.Server.ItemRev

type Rep ItemKnown = D1 ('MetaData "ItemKnown" "Game.LambdaHack.Server.ItemRev" "LambdaHack-0.11.0.0-inplace" 'False) (C1 ('MetaCons "ItemKnown" 'PrefixI 'False) (S1 ('MetaSel ('Nothing :: Maybe Symbol) 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 ItemIdentity) :*: (S1 ('MetaSel ('Nothing :: Maybe Symbol) 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 AspectRecord) :*: S1 ('MetaSel ('Nothing :: Maybe Symbol) 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe FactionId)))))

data NewItem

Constructors

NewItem (GroupName ItemKind) ItemKnown ItemFull ItemQuant

NoNewItem

type ItemRev = HashMap ItemKnown ItemId

Reverse item map, for item creation, to keep items and item identifiers in bijection.

type UniqueSet = EnumSet (ContentId ItemKind)

newItemKind :: COps -> UniqueSet -> Freqs ItemKind -> AbsDepth -> AbsDepth -> Int -> Frequency (GroupName ItemKind, ContentId ItemKind, ItemKind)

Roll an item kind based on given Freqs and kind rarities

newItem :: COps -> Frequency (GroupName ItemKind, ContentId ItemKind, ItemKind) -> FlavourMap -> DiscoveryKindRev -> AbsDepth -> AbsDepth -> Rnd NewItem

Given item kind frequency, roll item kind, generate item aspects based on level and put together the full item data set.

Item discovery types

data DiscoveryKindRev

The reverse map to DiscoveryKind, needed for item creation. This is total and never changes, hence implemented as vector. Morally, it's indexed by ContentId ItemKind and elements are ItemKindIx.

Instances

Show DiscoveryKindRev

Defined in Game.LambdaHack.Server.ItemRev

Methods

showsPrec :: Int -> DiscoveryKindRev -> ShowS

show :: DiscoveryKindRev -> String

showList :: [DiscoveryKindRev] -> ShowS

Binary DiscoveryKindRev

Defined in Game.LambdaHack.Server.ItemRev

Methods

put :: DiscoveryKindRev -> Put

get :: Get DiscoveryKindRev

putList :: [DiscoveryKindRev] -> Put

emptyDiscoveryKindRev :: DiscoveryKindRev

serverDiscos :: COps -> DiscoveryKindRev -> Rnd (DiscoveryKind, DiscoveryKindRev)

The FlavourMap type

data FlavourMap

Flavours assigned by the server to item kinds, in this particular game. This is total and never changes, hence implemented as vector. Morally, it's indexed by ContentId ItemKind and elements are Flavour.

Instances

Show FlavourMap

Defined in Game.LambdaHack.Server.ItemRev

Methods

showsPrec :: Int -> FlavourMap -> ShowS

show :: FlavourMap -> String

showList :: [FlavourMap] -> ShowS

Binary FlavourMap

Defined in Game.LambdaHack.Server.ItemRev

Methods

put :: FlavourMap -> Put

get :: Get FlavourMap

putList :: [FlavourMap] -> Put

emptyFlavourMap :: FlavourMap

dungeonFlavourMap :: COps -> FlavourMap -> Rnd FlavourMap

Randomly chooses flavour for all item kinds for this game.

Important implementation parts, exposed for tests

rollFlavourMap :: Vector Word16 -> Rnd (EnumMap (ContentId ItemKind) Flavour, EnumMap (ContentSymbol ItemKind) (EnumSet Flavour)) -> ContentId ItemKind -> ItemKind -> Rnd (EnumMap (ContentId ItemKind) Flavour, EnumMap (ContentSymbol ItemKind) (EnumSet Flavour))

Assigns flavours to item kinds. Assures no flavor is repeated for the same symbol, except for items with only one permitted flavour.

Internal operations

buildItem :: COps -> AspectRecord -> FlavourMap -> DiscoveryKindRev -> ContentId ItemKind -> Item

Build an item with the given kind and aspects.

keepMetaGameInformation :: ContentData ItemKind -> Vector Word16 -> Vector Word16

Keep in a vector the information that is retained from playthrough to playthrough. The information being, e.g., ItemKindIx or Flavour. The information is morally indexed by ContentId ItemKind and its Enum instance fits in Word16.