Engine:
* Updated example scripts to fallback to English texts if localized text is missing
-- Hedgewars Bazooka Training
-- Scripting Example
-- Lines such as this one are comments - they are ignored
-- by the game, no matter what kind of text is in there.
-- It's also possible to place a comment after some real
-- instruction as you see below. In short, everything
-- following "--" is ignored.
---------------------------------------------------------------
-- At first we put all text we'd like to use in some arrays.
-- This way we're able to localize the text to be shown without
-- modifying other files.
-- The language to be used is stored in the global variable
-- 'L' that is set by the game (string).
-- Text may then be accessed using "arrayname[L]".
local caption = {
["en"] = "Bazooka Training",
["de"] = "Bazooka-Training"
}
local subcaption = {
["en"] = "Aiming Practice",
["de"] = "Zielübung"
}
local goal = {
["en"] = "Eliminate all targets before your time runs out.|You have unlimited ammo for this mission.",
["de"] = "Eliminiere alle Ziele bevor die Zeit ausläuft.|Du hast in dieser Mission unbegrenzte Munition."
}
local timeout = {
["en"] = "Oh no! Time's up! Just try again.",
["de"] = "Oh nein! Die Zeit ist um! Versuche es nochmal."
}
local success = {
["en"] = "Congratulations! You've eliminated all targets|within the allowed time frame.",
["de"] = "Gratulation! Du hast alle Ziele innerhalb der|verfügbaren Zeit ausgeschaltet."
}
local teamname = {
["en"] = "'Zooka Team",
["de"] = "Die Knalltüten"
}
local hogname = {
["en"] = "Hunter",
["de"] = "Jäger"
}
-- To handle missing texts we define a small wrapper function that
-- we'll use to retrieve text.
local function loc(text)
if text == nil then return "**missing**"
elseif text[L] == nil then return text["en"]
else return text[L]
end
end
---------------------------------------------------------------
-- This variable will hold the number of destroyed targets.
local score = 0
-- This variable represents the number of targets to destroy.
local score_goal = 5
-- This variable controls how many milliseconds/ticks we'd
-- like to wait before we end the round once all targets
-- have been destroyed.
local end_timer = 5000 -- 5000 ms = 5 s
-- This variable is set to true if the game is lost (i.e.
-- time runs out).
local game_lost = false
-- This variable will point to the hog's gear
local player = nil
-- This variable will grab the time left at the end of the round
local time_goal = 0
-- This is a custom function to make it easier to
-- spawn more targets with just one line of code
-- You may define as many custom functions as you
-- like.
function spawnTarget()
-- add a new target gear
gear = AddGear(0, 0, gtTarget, 0, 0, 0, 0)
-- move it to a random position within 0 and
-- LAND_WIDTH - the width of the map
FindPlace(gear, true, 0, LAND_WIDTH)
-- move the target to a higher vertical position
-- to ensure it's not somewhere down below
x, y = GetGearPosition(gear)
SetGearPosition(gear, x, 500)
end
-- This function is called before the game loads its
-- resources.
-- It's one of the predefined function names that will
-- be called by the game. They give you entry points
-- where you're able to call your own code using either
-- provided instructions or custom functions.
function onGameInit()
-- At first we have to overwrite/set some global variables
-- that define the map, the game has to load, as well as
-- other things such as the game rules to use, etc.
-- Things we don't modify here will use their default values.
-- The base number for the random number generator
Seed = 0
-- Game settings and rules
GameFlags = gfMultiWeapon + gfOneClanMode + gfSolidLand
-- The time the player has to move each round (in ms)
TurnTime = 60000
-- The frequency of crate drops
CaseFreq = 0
-- The number of land objects being placed
LandAdds = 0
-- The delay between each round
Delay = 0
-- The map to be played
Map = "Bamboo"
-- The theme to be used
Theme = "Bamboo"
-- Create the player team
AddTeam(loc(teamname), 14483456, "Simple", "Island", "Default")
-- And add a hog to it
player = AddHog(loc(hogname), 0, 1, "NoHat")
SetGearPosition(player, 1960, 1160);
end
-- This function is called when the round starts
-- it spawns the first target that has to be destroyed.
-- In addition it shows the scenario goal(s).
function onGameStart()
-- Spawn the first target.
spawnTarget()
-- Show some nice mission goals.
-- Parameters are: caption, sub caption, description,
-- extra text, icon and time to show.
-- A negative icon parameter (-n) represents the n-th weapon icon
-- A positive icon paramter (n) represents the (n+1)-th mission icon
-- A timeframe of 0 is replaced with the default time to show.
ShowMission(loc(caption), loc(subcaption), loc(goal), -amBazooka, 0);
end
-- This function is called every game tick.
-- Note that there are 1000 ticks within one second.
-- You shouldn't try to calculate too complicated
-- code here as this might slow down your game.
function onGameTick()
-- If time's up, set the game to be lost.
-- We actually check the time to be "1 ms" as it
-- will be at "0 ms" right at the start of the game.
if TurnTimeLeft == 1 and score < score_goal then
game_lost = true
-- ... and show a short message.
ShowMission(loc(caption), loc(subcaption), loc(timeout), -amSkip, 0);
-- How about killing our poor hog due to his poor performance?
SetHealth(player, 0);
-- Just to be sure set the goal time to 1 ms
time_goal = 1
end
-- If the goal is reached or we've lost ...
if score == score_goal or game_lost then
-- ... check to see if the time we'd like to
-- wait has passed and then ...
if end_timer == 0 then
-- ... end the game ...
EndGame()
else
-- ... or just lower the timer by 1.
end_timer = end_timer - 1
-- Reset the time left to stop the timer
TurnTimeLeft = time_goal
end
end
end
-- This function is called when the game is initialized
-- to request the available ammo and probabilities
function onAmmoStoreInit()
-- add an unlimited supply of bazooka ammo
SetAmmo(amBazooka, 9, 0)
end
-- This function is called when a new gear is added.
-- We don't need it for this training, so we can
-- keep it empty.
function onGearAdd(gear)
end
-- This function is called before a gear is destroyed.
-- We use it to count the number of targets destroyed.
function onGearDelete(gear)
-- We're only interested in target gears.
if GetGearType(gear) == gtTarget then
-- Add one point to our score/counter
score = score + 1
-- If we haven't reached the goal ...
if score < score_goal then
-- ... spawn another target.
spawnTarget()
else
if not game_lost then
-- Otherwise show that the goal was accomplished
ShowMission(loc(caption), loc(subcaption), loc(success), 0, 0);
-- Also let the hogs shout "victory!"
PlaySound(sndVictory)
-- Save the time left so we may keep it.
time_goal = TurnTimeLeft
end
end
end
end