시스템 함수

다음 시스템 함수를 사용할 수 있습니다:

print

print(arg1, arg2, arg3, ...);

print 명령은 원하는 표현식을 출력할 수 있게 해줍니다.
출력된 메시지는 뷰어의 Sample 탭에서 user 로그 카테고리로 볼 수 있습니다.
print에 넘길 수 있는 인수 개수 제한은 없습니다.
print 자체의 평가값은 항상 0입니다.

정보

예외적으로 print는 숫자와 문자열을 모두 인수로 받을 수 있습니다. 다음 코드는 유효합니다:

print("this is a number: ", 1); // note the space after the :

print는 각 인수를 계산한 뒤 하나의 문자열로 이어 붙여 debug 출력에 표시합니다.

정보

숫자로 계산되는 유효한 표현식도 출력할 수 있습니다. 예를 들면:

print("bennett's current energy is: ", .bennett.energy);

sleep/wait

주의

The syntax wait(arg), while valid, is deprecated in favour of sleep(arg)

sleep(arg);
wait(arg); //deprecated, use sleep(arg)

sleep is a special function that will ask Evilsim to wait a number of frames.
sleep will always evaluate to 0.

위험

arg must be a number or an expression that evaluates to a number and represents the number of frames the simulator will wait for.

주의

Due to how Evilsim handles actions, the current implementation of sleep is not intuitive when trying to extend the duration of actions. Please use delay for this purpose instead.

예시:

keqing attack;  // Keqing N1
sleep(2);       // sleeps for 2 frames
keqing attack;  // Keqing N2

Many users would expect that Evilsim sleeps for 2 frames after Keqing's N1 action ends. This is not how sleep works. sleep makes the sim sleep for 2 frames after Keqing's N1 action has reached its specified CanQueueAfter value. The duration of sleep counts towards the action length.

expected:
- N1 starts
- N1 ends after 15 frames
- Evilsim sleeps for 2 frames
- N2 starts after a total of 15 + 2 = 17 frames
reality:
- N1 starts
- N1 CanQueueAfter is reached after 11 frames
- Evilsim sleeps for 2 frames
- now there are 15 - (11 + 2) = 2 frames left in the N1 animation
- N1 continues for 2 more frames until the N1 animation is over
- N2 starts after a total of 11 + 2 + 2 = 15 frames

To make Evilsim sleep for 1 frame after Keqing's N1 action ends, the user would have to insert a sleep(5);.

delay

delay(arg);

delay is a special function that will ask Evilsim to delay the start of the following action by a number of frames.
delay will always evaluate to 0.

위험

arg must be a number or an expression that evaluates to a number and represents the number of frames the simulator will wait for.

주의

delay is executed before the sim checks if the next action is ready.

예시:

keqing burst;
delay(5);
keqing burst;

In this case, the sim would do the following:

Keqing's 1st 원소폭발 is executed
Evilsim executes a delay for 5 frames at the end of the previous action
Once the delay is over, Evilsim checks if Keqing's 2nd 원소폭발 can be executed
Since there is not enough energy, the sim will be stuck waiting for energy
After enough particles were collected from energy drops, Keqing's 2nd 원소폭발 is executed

주의

If the active character is affected by hitlag during the execution of delay, then it will last longer than specified.

예시:

noelle skill;
sleep(700);
delay(50);
noelle attack;

This example uses C4 Noelle to show a source of hitlag that can occur during delay. The sleep is used so that the C4 shield explosion happens during delay.

Noelle's 원소전투 스킬 is executed
Evilsim will sleep for 700 frames after the CanQueueAfter of the previous action
Evilsim starts executing a delay that should last 50 frames
A few frames after delay starts, C4 Noelle applies 13 frames of hitlag
Noelle's Attack is executed 50 + 13 = 63 frames after the start of delay

f

f();

f is function that takes no argument and will evaluate to the current frame number Evilsim is on.

rand

rand();

rand evaluates to an uniformly distributed random number between 0 and 1.

randnorm

randnorm();

randnorm evaluates to a normally distributed random number with mean 0 and std dev of 1.

type

type(arg);

type evaluates to the name of the gcsl type of arg.

execute_action

위험

THIS FUNCTION IS EXPERIMENTAL AND SUBJECT TO CHANGE.

USE AT YOUR OWN RISK.

execute_action(char, action, params);

execute_action evaluates to null and is used by the sim to execute actions. The intent behind this system function is to allow for proper typing/functional support in the future. It being exposed here is an unintended side effect which can be used to implement a function that runs before every action.

위험

The following example is subject to breaking in the future!

With that in mind it is possible to add (random) frame delays before each action:

fn rand_delay(mean, stddev) {
    let del = randnorm() * stddev + mean;
    if del > (mean + mean) {
        del = mean + mean;
    }
    delay(del);
}

let prev_char_id = -1;
let prev_action_id = -1;

let _execute_action = execute_action;
fn execute_action(char_id number, action_id number, p map) {
    print(prev_char_id, " ", prev_action_id, " ", char_id, " ", action_id);

    if action_id == .action.swap {
        # add delay before swap
        rand_delay(12, 3);
    } else if prev_action_id == .action.attack && action_id != .action.attack && action_id != .action.charge {
        # add delay after attack, but only if not followed by another attack or charge
        rand_delay(3, 1);
    } else if prev_action_id != .action.attack {
        # add delay to everything else
        rand_delay(3, 1);
    }

    prev_char_id = char_id;
    prev_action_id = action_id;
    return _execute_action(char_id, action_id, p);
}

위험

char and action must be a number or an expression that evaluates to a number.
params must be a map or an expression that evaluates to a map.

set_particle_delay

set_particle_delay(arg1, arg2);

set_particle_delay will set the 기본값 particle delay for the character supplied in arg1 to the value in arg2.
If arg2 evaluates to a number that is less than 0, 0 will be used.
set_particle_delay will always evaluate to 0.

위험

arg1 must be a string (wrapped in double quotes) and arg2 must be a number or an expression that evaluates to a number.

정보

예시:

set_particle_delay("xingqiu", 100);

set_swap_icd

set_swap_icd(arg1);

주의

This function replicates behavior not found in typical gameplay.
By 기본값, characters in Genshin cannot swap more than once per second. However, by 'booking' (opening the Adventurer's Handbook mid-combat), the swap timer can continue while other in-game timers (such as the Spiral Abyss timer) remain paused.
If you use this function, the resulting dps will not represent damage per real time, but will instead represent damage per in-game time.

set_swap_icd will set the 기본값 swap ICD for all characters equal to the number of frames in arg1.
If arg1 evaluates to a number that is less than 0, an error will be returned.
set_swap_icd will always evaluate to 0.

위험

arg1 must be a number or an expression that evaluates to a number.

정보

예시:

set_swap_icd(0);

set_기본값_target

set_default_target(arg);

set_기본값_target will set the 기본값 target to the index supplied by arg.
set_기본값_target will always evaluate to 0.

위험

arg must be a number or an expression that evaluates to a number.

위험

If arg is an invalid target (i.e. 3 when there are only 2 targets), then Evilsim will exit with an error.

정보

예를 들어, if there are 2 targets, then set_기본값_target(2) will set the 기본값 target to the 2nd one. Note that it starts at 1 and not 0 because 0 is a special case (target 0 represents the player).

set_player_pos

set_player_pos(x, y);

set_player_pos will set the player's current position to the supplied x and y coordinate.
set_player_pos will always evaluate to 0.

위험

x and y must be a number or an expression that evaluates to a number.

set_target_pos

set_target_pos(arg, x, y);

set_target_pos will set the target with index arg to the supplied x and y coordinates.
set_target_pos will always evaluate to 0.

위험

All arguments must be a number or an expression that evaluates to a number.

위험

If arg is an invalid target (i.e. 3 when there are only 2 targets), then Evilsim will exit with an error.

kill_target

kill_target(arg);

kill_target will kill the target with index arg.
kill_target will always evaluate to 0.

위험

arg must be a number or an expression that evaluates to a number.

위험

If arg is an invalid target (i.e. 3 when there are only 2 targets), then Evilsim will exit with an error.

is_target_dead

위험

THIS FUNCTION IS EXPERIMENTAL AND SUBJECT TO CHANGE.

USE AT YOUR OWN RISK.

is_target_dead(arg);

is_target_dead will evaluates to 1 if the target with index arg is dead and 0 otherwise.

위험

arg must be a number or an expression that evaluates to a number.

위험

If arg is an invalid target (i.e. 3 when there are only 2 targets), then Evilsim will exit with an error.

pick_up_crystallize

pick_up_crystallize(element);

pick_up_crystallize will pick up the oldest crystallize shard with the specified element supplied as a string.
pick_up_crystallize will not pick up any shard if:
no shard with the specified element exists
there is a shard with the specfied element, but it cannot be picked up yet
pick_up_crystallize will return the number of crystallize shards that were picked up (either 0 or 1).

정보

element can also be "any" to pick up the oldest crystallize shard of any element.

위험

element must be a string or an expression that evaluates to a string.

is_even

is_even(arg);

is_even evaluates if a given number is even or not. If a number is a floating point, the number if floored first.

위험

arg must be a number or an expression that evaluates to a number.

sin

sin(arg);

sin evaluates to the sine of the given arg.

위험

arg must be a number or an expression that evaluates to a number.

cos

cos(arg);

cos evaluates to the cosine of the given arg.

위험

arg must be a number or an expression that evaluates to a number.

asin

asin(arg);

asin evaluates to the arcsine of the given arg.

위험

arg must be a number or an expression that evaluates to a number.

acos

acos(arg);

acos evaluates to the arccos of the given arg.

위험

arg must be a number or an expression that evaluates to a number.

set_on_tick

위험

THIS FUNCTION IS EXPERIMENTAL AND SUBJECT TO CHANGE.

USE AT YOUR OWN RISK.

set_on_tick(func);

set_on_tick evaluates to null and is a way to make the sim execute a user-defined function every frame.

In the following example, the player's stamina will be printed every frame:

fn stam() {
    print(.stam);
}
set_on_tick(stam);

위험

func must be a function or an expression that evaluates to a function.

print​

sleep/wait​

delay​

f​

rand​

randnorm​

type​

execute_action​

set_particle_delay​

set_swap_icd​

set_기본값_target​

set_player_pos​

set_target_pos​

kill_target​

is_target_dead​

pick_up_crystallize​

is_even​

sin​

cos​

asin​

acos​

set_on_tick​

print

sleep/wait

delay

f

rand

randnorm

type

execute_action

set_particle_delay

set_swap_icd

set_기본값_target

set_player_pos

set_target_pos

kill_target

is_target_dead

pick_up_crystallize

is_even

sin

cos

asin

acos

set_on_tick