Difference between revisions of "FOCS Scripting Details"

Revision as of 09:48, 3 July 2004

Unofficial

Contents of this document have not undergone public review.

Introduction

Each tech, building, and planet special will probably be encoded as XML, including mark-up tags describing the effects of the object.

In v.3, if these are the only two classes of effects: Modify Meter and Unlock Item. An objects can have multiple effects, but no conditions beyond what is offered by the Effect Classes.

Modify Meter

Effect Name

The name of the effect, mostly for internal usage. Effects can share the same name, meaning they will not stack if the stacking flag is set. Effects that share names should have identical bonuses.)

(programming note: "sharing a name" means that they share the same StackingID.)

Scope

• Galaxy The effect operates on the meters of every planet in the galaxy • Empire The effect operates on the meters belonging to every planet in the empire. • Sector The effect operates on the meters belonging to the planets contained by the Target system and any planets in systems connected to the target system by a starlane or wormhole. • System The effect operates on the meters belonging to the planets contained by the Target system. • Planet The effect operates on a single planet.

Effect Affiliation

• All: The effect influences the meters of every planet, regardless of empire affiliation. • Exclusive: The effect only acts on planets owned by the target Empire. • Friends: The effect only acts the meters of on objects owned by the target Empire and allied Empires. (not required in v.3) • Enemies: The effect only acts the meters of objects owned by empires unfriendly with the target Empire. (every empire is considered unfriendly in v.3)

Meter

• Farming • Industry • Mining • Science • Economic • Health (growth of Population) • Construction (growth of Infra) • Enviroment (The results of Enviromental Preference) • Security (not in v.3) • Happiness (not in v.3)

Type of Modification

• Additive The default.
• Multiplicative Should be used rarely. The Modification value is multiplied with the Multiplier of the meter. (The Meter’s multiplier is then multiplied with the meter itself after all effects have executed.)

Value of Modification

The value that is added to or multipled with the meter.

Stacking

Does the effect stack?

Focus Condition

• None Effect occurs regardless of planet focus
• Primary Effect only occurs if the Meter being modified is set as the Primary
• Secondary Effect only occurs if the Meter being modified is set as Primary or Secondary

Infra Condition

If total infrastructure is less than this value, the effect is canceled.

=Enviromental Condition

Either None, or the Enviroment in which this effect operates:

• Terran
• Ocean
• Swamp
• Toxic
• Inferno
• Radiated
• Barren
• Turdra
• Desert
• Gaian

Description

Appended to the tooltip of the affected meter.

Unlock Item

Techs, buildings, and ship parts can be unlocked. An unlocked Tech can be researched, an unlocked building or ship part can be constructed.

Type

The nature of the item being unlocked:

• Tech A single technology
• Tech Branch An entire branch of the tech tree.
• Building
• Ship Part (in version v.3, ship "parts" are scout, colony, mark I-V)

ItemID

The unique name of the item being unlocked.

Duration

• Permanent The item remains unlocked for the entire game.
• Life of Effect When the effect is destoyed, the item returns to being

locked. For example, if a buiding that opens up a special part of the

tech tree is destoryed, that branch of the tree would be closed for

research.

Examples

Universal University

(building) The Universal University offers a quality education to budding young science geeks.

The U.U. has two effects:

Advanced Education Scope: Empire Affliation: Exclusive Meter: Science Type of Modification: Additive Value of Modification: +1 Stacking: Does not stack Focus Condition: None Infra Condition: 5 Enviro Condition: None Description: +1 Science to Developed worlds from Universal University

Science Inspiration Scope: Sector Affliation: Friends Meter: Science Type of Modification: Additive Value of Modification: +1 Stacking: Does not stack Focus Conditions: Primary Infra Conitions: 5 Enviro Condidtion: None Description: +1 Research to Developed Science worlds, due to a nearby Universal University

Ocean Survival

(Tech) Your empire has developed methods of surviving and exploiting Ocean worlds.

Two effects: Floating Platforms Scope: Empire Affliation: Exclusive Meter: Enviroment Type of Modification: Additive Value of Modification: +2 Stacking: Does not stack Focus Condition: None Infra Condition: None Enviro Condition: Ocean Description: +2 Enviroment from Ocean Survival

Fish n' Chips Scope: Empire Affliation: Exclusive Meter: Farming Type of Modification: Additive Value of Modification: +1 Stacking: Does not stack Focus Condition: Secondary Infra Condition: 1 Enviro Condition: Ocean Description: +1 Food to Ocean Farming Worlds from Ocean Survial

Hostile Microcobes

(Planet Special) Nasty little one celled horrors have proven resistant to extermination.

Two effects: Sickness Scope: Planet Affliation: Exclusive Meter: Health Type of Modification: Additive Value of Modification: -1 Stacking: Stacks Focus Condition: None Infra Condition: 0 Enviro Condition: None Description: -1 Health due to the Hostile Microcobes

Hostile Biology Scope: Planet Affliation: Exclusive Meter: Enviroment Type of Modification: Additive Value of Modification: -2 Stacking: Does not stack Focus Condition: None Infra Condition: 0 Enviro Condition: None Description: -2 Enviroment, because this planet's life hates you

Future Effects

There will be more Effect Classes in future versions, possibly

including:

Modify ShipPart

A modification of ship parts, improving or penalizing various stats.

This is meant for techs that refine parts, or buildings that give bonuses to certain unit types.

Modify Infrastructure

Directly effects the infrastructure (ie, Current Meter) of a planet, rather than the Max Meter. Useful for events like bombings or earthquakes.

Events style effects

Like the multiple choice events in EU2. If the game has 'em, it will probably require some kind of scripting.