API：関数ドキュメント

var currentPageID = Campaign().get('playerpageid'),
    currentPage = getObj('page', currentPageID)；

on('add:character', function(obj) {
    createObj('attribute', {
        name: 'Strength',
        current: 0,
        max：30,
        characterid: obj.id
    });
})；

createObj('path', {
    left: 7000,
    top：140,
    width: 140,
    height: 140,
    layer: 'objects',
    path：JSON.stringify([['M', 0, 0], ['L', 70, 0], ['L', 0, 70], ['L', 0, 0])
})；

var handout = createObj('handout', {
    name: 'A Letter Addressed to You',
    inplayerjournals: 'all',
    archived: false
});
handout.set({
    notes: 'Notes can only be set after the handout is created',
    gmnotes: 'GM Notes can only be set after the handout is created'
})；

var tokenName = getMyTokenName(),
    duplicateTokens = filterObjs(function(obj) {
        if (obj.get('type') !== 'graphic' || obj.get('subtype') ！== 'token' || obj.get('name') === tokenName) return false;
        return obj.get('name').indexOf(tokenName) === 0 && /d+$/.text(obj.get('name'));
})；

var npcs = findObjs({ type: 'character', controlledby: '' })；

var everything = getAllObjs()；

var character = getMyCharacter(),
    strength = getAttrByName(character.id, 'strength'),
    strength_max = getAttrByName(character.id, 'strength', 'max')；

on('chat:message', function(msg) {
    var sendingPlayer = getObj('player', msg.playerid);
})；

on('chat:message', function(msg) {
    log('Message received from:');
    log(getObj('player', msg.playerid));
})；

"Message received from:"
{"_d20userid":"123456","_displayname":"John Doe","speakingas":"","_online":true,"color":"#885b68","_macrobar":"-J16Z-dRU5tleKiKOg0X|-K3F_4q_b1p-Vdiwgn1t","showmacrobar":true,"_id":"-J16Z-dRU5tleKiKOc0X","_type":"player","_lastpage":""}

on('change:graphic', function1);
on('change:graphic', function2);
on('change:graphic:left', function3)；

on('add:graphic', function(obj) {
    // セッションが始まると、この関数はキャンペーン内のすべてのグラフィックに対して呼び出されます
    // この関数は、新しいグラフィックRoll20オブジェクトが作成されるたびに呼び出されます
});

on('ready', function() {
    on('add:graphic', function(obj) {
        // この関数は、新しいグラフィックRoll20オブジェクトが作成されるときにのみ*呼び出され、既に存在するものに対しては呼び出されません
    });
})；

on('change:graphic', function(obj, prev) {
    var id1 = obj.id, // 3つとも等価
        id2 = obj.get('id'),
        id3 = obj.get('_id'),

        id4 = prev.id, // 未定義
        id5 = prev.get('id'), // 未定義は関数ではない
        id6 = prev._id; // 正しい

    // どちらも等価
    obj.set('left', 70);
    obj.set({
        left: 70
    });

    prev.set('left', 70); // undefined は関数ではない
    prev.set({ // undefined は関数ではない
        left: 70
    });
    prev.left = 70; // 正しいが、卓上では何も変わらない
})；

on('ready', function() {
    if (!state.example) state.example = { bioCache：{}};
});

on('change:character:bio', function(obj, prev) {
    obj.get('bio', function(text) {
        state.example.bioCache[obj.id] = text;

        // do stuff....

        if (shouldRevertBio()) {
            obj.set('bio', state.example.bioCache[obj.id]);
        }.
    });
})；

var myCharacter = ...,
    mySourceAttr = findObjs({ type: 'attribute', characterid: myCharacter.id, name: 'mySourceAttribute' })[0];

onSheetWorkerCompleted(function() {
    var calculatedAttr = findObjs({ type: 'attribute', characterid: myCharacter.id, name: 'myCalculatedAttribute' })[0];
    // calculatedAttr.get('current') で何かする;
});
mySourceAttr.setWithWorker({ current: 5 })；

on('chat:message', function(msg) {
    if (msg.type !== 'api') return;

    if (msg.content.indexOf('!playercommand') === 0) {
        // ...
    } else if (msg.content.indexOf('!gmcommand') === 0) {
        if (!playerIsGM(msg.playerid)) return;
        // ...
    }
});

var playlists = JSON.parse(Campaign().get('jukeboxfolder')),
    myPlaylist = _.find(playlists, (folder) => _.isObject(folder) && folder.n === myPlaylistName);
playJukeboxPlaylist(myPlaylist.id)；

var d20Result = randomInteger(20); // 20面ダイスを振るのとほぼ同じ。

sendChat('例', 'これは簡単な例です。')；

on('chat:message', function(msg) {
    var character = findObjs({ type: 'character', name: msg.who })[0],
        player = getObj('player', msg.playerid),
        message = ' said something';

    if (character) sendChat('character|'+character.id, character.get('name')+message);
    else sendChat('player|'+player.id, player.get('displayname')+message);
})；

sendChat('', '/r 2d20k1+'+strengthMod, function(ops) {
    var msg = ops[0];
    // ...
});

sendChat('System', '[Clear changes](!clear)\n[Add tile](!add)\n[View sample](!view)\n[Save layout](!save)', null, { noarchive: true })；

on('chat:message', function(msg) {
    var obj;
    if (msg.type === 'api' && msg.content.indexOf('!ping') === 0) {
        if (!msg.selected) return;
        obj = getObj(msg.selected[0]._type, msg.selected[0]._id);
        sendPing(obj.get('left'), obj.get('top'), obj.get('pageid'), msg.playerid, true); // 選択されたトークンの中央に全員を配置
    }.
});

spawnFx(1400, 1400, 'bubbling-acid')；

spawnFxBetweenPoints({ x: 1400, y: 1400 }, { x: 2100, y: 2100 }, 'beam-acid')；

// この2つは等価である
spawnFx(1400, 1400, 'bubbling-acid');
spawnFxWithDefinition(1400, 1400, {
    maxParticles：200,
    size: 15,
    sizeRandom：3,
    lifeSpan: 20,
    lifeSpanRandom：5,
    speed: 7,
    speedRandom: 2,
    gravity： { x: 0.01, y: 0.65 }
    angle: 270,
    angleRandom：35,
    emissionRate：1,
    startColour: [0, 35, 10, 1],
    startColourRandom：[0, 10, 10, 0.25],
    endColour: [0, 75, 30, 0],
    endColourRandom：   [0, 20, 20, 0]
})；

stopJukeboxPlaylist()；

on('chat:message', function(msg) {
    if (msg.type === 'api' && msg.content === '!toback' && msg.selected) {
        _.each(msg.selected, (s) => {
            toBack(getObj(s._type, s._id));
        });
    }.
});

on('ready', function() {
    on('add:graphic', function(obj) {
        toFront(obj);
    });
})；