-
Notifications
You must be signed in to change notification settings - Fork 102
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
- Loading branch information
Showing
43 changed files
with
1,523 additions
and
128 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,42 @@ | ||
| ### Block Destroyed | ||
|
|
||
| Tracks and manages the player's progress in a challenge where they must destroy specific blocks based on various conditions like block type, material, biome, or Points of Interest (POIs). | ||
|
|
||
| In an XML configuration file, the challenge might be set up like this: | ||
|
|
||
| ```xml | ||
| <objective type="BlockDestroyed, SCore" count="20" block="myblock" biome="burn_forest" poi="traderJen" /> | ||
| <objective type="BlockDestroyed, SCore" count="20" material="myMaterial" biome="pine_forest" poi_tags="wilderness" /> | ||
| ``` | ||
| These configurations define challenges where the player must: | ||
|
|
||
| Destroy 20 blocks named myblock located in the burn_forest biome and associated with the POI traderJen. | ||
| Destroy 20 blocks made of myMaterial, located in the pine_forest biome, and associated with POIs that have the tag wilderness. | ||
|
|
||
| More Examples: | ||
|
|
||
| <objective type="BlockDestroyed, SCore" count="20" block="cntRetroFridgeVer1Closed" /> | ||
| <objective type="BlockDestroyed, SCore" count="20" block="cntRetroFridgeVer1Closed" biome="burn_forest" /> | ||
| <objective type="BlockDestroyed, SCore" count="20" block="cntRetroFridgeVer1Closed" biome="burn_forest" poi="traderJen" /> | ||
| <objective type="BlockDestroyed, SCore" count="20" material="Mmetal" biome="pine_forest" poi_tags="wilderness" /> | ||
|
|
||
|
|
||
| --- | ||
|
|
||
| ### Block Upgrades | ||
|
|
||
| Tracks and manages the player's progress in a challenge where they need to upgrade blocks in the game, possibly using specific items, in specific biomes, or while holding certain tools. | ||
|
|
||
| In an XML configuration file, the challenge might be set up like this: | ||
|
|
||
| ```xml | ||
| <objective type="BlockUpgradeSCore,SCore" block="frameShapes:VariantHelper" count="10" held="meleeToolRepairT0StoneAxe" needed_resource="resourceWood" needed_resource_count="8" /> | ||
| <objective type="BlockUpgradeSCore,SCore" block_tags="wood" count="10" held="meleeToolRepairT0StoneAxe" needed_resource="resourceWood" needed_resource_count="8" /> | ||
| <objective type="BlockUpgradeSCore,SCore" block_tags="wood" count="10" biome="burnt_forest" /> | ||
| ``` | ||
|
|
||
| These configurations define challenges where the player must: | ||
|
|
||
| Upgrade 10 specific blocks named frameShapes:VariantHelper while holding a stone axe and using resourceWood as a required material. | ||
| Upgrade 10 blocks tagged as wood with the same tool and resource requirements. | ||
| Upgrade 10 blocks tagged as wood while being in the burnt_forest biome. |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,49 @@ | ||
| # Challenges | ||
|
|
||
| ### Challenges Overview | ||
|
|
||
| Challenges were introduced into the game in the first **V1 release**. The **0-SCore** mod has expanded the available challenges. | ||
|
|
||
| ### Notes: | ||
|
|
||
| Challenges are defined in the `challenges.xml` file. There are 3 parts to a challenge: | ||
|
|
||
| 1. **Challenge Category**: | ||
| This creates a new category at the top of the Challenges window. | ||
|
|
||
| ```xml | ||
| <challenge_category name="AbilityCategory" title="Ability Challenges" icon="ui_game_symbol_challenge_category2" /> | ||
| ``` | ||
|
|
||
| 2. **Challenge Group**: | ||
| This creates a new group, which is a row in a new category. Up to 10 challenges can be added to a group. | ||
|
|
||
| ```xml | ||
| <challenge_group category="AbilityCategory" name="PerceptionGroup" title_key="perceptionChallenges_key" reward_text_key="No Rewards" reward_event="NoEvent" /> | ||
| ``` | ||
|
|
||
| 3. **Individual Challenge**: | ||
| This is an individual challenge that is added to the row. | ||
|
|
||
| ```xml | ||
| <challenge name="rifle01" | ||
| title_key="gunRifleT0PipeRifle" | ||
| icon="ui_game_symbol_long_shot" | ||
| group="PerceptionGroup" | ||
| short_description_key="challengeKillZombies" | ||
| description_key="challengeKillZombiesDesc" | ||
| reward_text_key="challenge_reward_1000xp" | ||
| reward_event="challenge_reward_1000"> | ||
|
|
||
| <objective type="KillWithItem, SCore" count="10" item="gunRifleT0PipeRifle" /> | ||
| </challenge> | ||
| ``` | ||
|
|
||
| ### Examples: | ||
|
|
||
| Examples can be found [here](https://github.com/SphereII/SphereII.Mods/tree/master/Mods/SphereII%20Challenges/Config). | ||
|
|
||
| [View Challenges Related to Fire](FireChallenges.md) | ||
| [View Challenges Related to Blocks](BlocksChallenges.md) | ||
| [View Challenges Related to Kills](KillChallenges.md) | ||
| [View Challenges Related to Player Activities](PlayerChallenges.md) |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,54 @@ | ||
|
|
||
|
|
||
| ### Start A Fire | ||
|
|
||
| This class defines a challenge where the player must **start a specific number of fires**. It tracks when the player starts fires and updates the challenge’s progress accordingly. | ||
|
|
||
| In an XML configuration file, the challenge might be set up like this: | ||
|
|
||
| ```xml | ||
| <objective type="StartFire, SCore" count="20" /> | ||
| ``` | ||
|
|
||
| This configuration defines a challenge where the player must **start 20 fires** to complete the objective. | ||
|
|
||
| --- | ||
|
|
||
| ### Block Destroyed By Fire | ||
|
|
||
| Tracks and manages the player's progress in a challenge where they need to destroy a certain number of blocks using fire. | ||
|
|
||
| In an XML configuration file, the challenge might be set up like this: | ||
|
|
||
| ```xml | ||
| <objective type="BlockDestroyedByFire, SCore" count="20" /> | ||
| ``` | ||
|
|
||
| This configuration defines a challenge where the player must destroy 20 blocks using fire. | ||
|
|
||
| --- | ||
|
|
||
| ### Extinguish Fire | ||
|
|
||
| Tracks and manages the player's progress in a challenge where they need to extinguish a certain number of fires. | ||
|
|
||
|
|
||
| In an XML configuration file, the challenge might be set up like this: | ||
|
|
||
| ```xml | ||
| <objective type="ExtinguishFire, SCore" count="20" /> | ||
| ``` | ||
| This configuration defines a challenge where the player must extinguish 20 fires. | ||
|
|
||
|
|
||
| ### Start Big Fire | ||
|
|
||
| Tracks and manages the player's progress in a challenge where they need to sustain or reach a large fire size or intensity, encouraging the player to create significant fires. | ||
|
|
||
| In an XML configuration file, the challenge might be set up like this: | ||
|
|
||
| ```xml | ||
| <objective type="BigFire, SCore" count="20" /> | ||
| ``` | ||
|
|
||
| This configuration defines a challenge where the player must sustain or create a "big fire" with a size or intensity of 20. |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,46 @@ | ||
| ### Kill With Item | ||
|
|
||
| This class defines a challenge where the player must kill specific entities (typically zombies) using certain items or items with specific tags. It extends the `ChallengeObjectiveKillByTag` class, allowing for more complex conditions like item-based kills, stealth checks, and additional localization options. | ||
|
|
||
| In an XML configuration file, the challenge might be set up like this: | ||
|
|
||
| ```xml | ||
| <objective type="KillWithItem, SCore" count="2" item="gunHandgunT1Pistol" /> | ||
| <objective type="KillWithItem, SCore" count="2" item_tags="handgunSkill" /> | ||
| <objective type="KillWithItem, SCore" count="2" item="gunHandgunT1Pistol" entity_tags="zombie" target_name_key="xuiZombies" /> | ||
| ``` | ||
|
|
||
| These configurations define challenges where the player must: | ||
|
|
||
| Kill 2 zombies using the gunHandgunT1Pistol. | ||
| Kill 2 zombies using any item tagged with handgunSkill. | ||
| Kill 2 zombies using the gunHandgunT1Pistol, with additional restrictions on entity tags and localized target name (xuiZombies). | ||
|
|
||
| --- | ||
|
|
||
| ### Decapitation | ||
|
|
||
| This class defines a challenge where the player must decapitate enemies (typically zombies) to complete the objective. It extends the `ChallengeObjectiveKillWithItem` class to incorporate additional logic specifically for monitoring decapitations as part of the challenge. | ||
|
|
||
| In an XML configuration file, the challenge might be set up like this: | ||
|
|
||
| ```xml | ||
| <objective type="Decapitation, SCore" count="2" /> | ||
| ``` | ||
|
|
||
| This configuration defines a challenge where the player must decapitate 2 entities (e.g., zombies) to complete the challenge. | ||
|
|
||
| --- | ||
|
|
||
| ### Stealth Kill Streak | ||
|
|
||
| This class defines a challenge where the player must perform consecutive stealth kills in order to complete the objective. The challenge is designed to track stealth kills and reset progress if the player fails to perform a stealth kill during the streak. | ||
|
|
||
| In an XML configuration file, the challenge might be set up like this: | ||
|
|
||
| ```xml | ||
| <objective type="StealthKillStreak, SCore" count="2" cvar="longestStreakCVar" /> | ||
| ``` | ||
| This configuration defines a challenge where the player must perform 2 consecutive stealth kills to complete the objective, and the longest streak is tracked using the CVar "longestStreakCVar". | ||
|
|
||
|
|
Oops, something went wrong.