UPDATED: 1/19/24' Just some "un-official" scripts or snippets from The Aaron (and a ton of official ones here ) that I've gathered from the forums over the years. I started this thread over 9 years ago! Some of these may no longer work. I've added newer scripts to the bottom of the list and will try and update others as needed. Enjoy.
>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>> Center-Align Small Tokens:
snap token's smaller than 70px to center of grid. <a href="https://app.roll20.net/forum/permalink/2343022/" rel="nofollow">https://app.roll20.net/forum/permalink/2343022/</a> on('ready', function () { 'use strict'; on('change:graphic', function (obj, prev) { if ( _.contains(['gmlayer', 'objects'], obj.get('layer')) && !obj.get('isdrawing') && (obj.get('left') !== prev.left || obj.get('top') !== prev.top) && (obj.get('width') < 70 || obj.get('height') < 70) ) { obj.set({ left: obj.get('left') + 35 - obj.get('width') / 2, top: obj.get('top') + 35 - obj.get('height') / 2 }); } }); }); Master Map Default:
On load, it will look for a page named MASTER (which can be archived). When a new page is created, it will copy all the settings from the MASTER page to the newly created one. <a href="https://app.roll20.net/forum/permalink/2343047/" rel="nofollow">https://app.roll20.net/forum/permalink/2343047/</a> on('ready', function() { "use strict"; var masterPage = findObjs({ type: 'page', name: 'MASTER' })[0]; if (masterPage) { on('add:page', function(p) { p.set({ showgrid: masterPage.get('showgrid'), showdarkness: masterPage.get('showdarkness'), showlighting: masterPage.get('showlighting'), lightupdatedrop: masterPage.get('lightupdatedrop'), lightenforcelos: masterPage.get('lightenforcelos'), lightrestrictmove: masterPage.get('lightrestrictmove'), lightglobalillum: masterPage.get('lightglobalillum'), width: masterPage.get('width'), height: masterPage.get('height'), snapping_increment: masterPage.get('snapping_increment'), grid_opacity: masterPage.get('grid_opacity'), fog_opacity: masterPage.get('fog_opacity'), background_color: masterPage.get('background_color'), gridcolor: masterPage.get('gridcolor'), grid_type: masterPage.get('grid_type'), scale_number: masterPage.get('scale_number'), scale_units: masterPage.get('scale_units'), gridlabels: masterPage.get('gridlabels'), diagonaltype: masterPage.get('diagonaltype') }); }); } else { sendChat('MasterPage', '/w gm No page named MASTER found.'); } }); Show Portrait/Avatar in Chat:
show a character/journal avatar in chat. <a href="https://app.roll20.net/forum/permalink/1548991/" rel="nofollow">https://app.roll20.net/forum/permalink/1548991/</a> on('ready', function () { on('chat:message', function (msg) { if (msg.type == 'api' && msg.content.indexOf('!char-pic') !== -1) { var charid = msg.content.split(' ')[1]; var c = getObj('character', charid); if (c) { var fPart = "<div style='box-shadow: 3px 3px 2px #888888; font-family: Verdana; text-shadow: 2px 2px #000; text-align: center; vertical-align: middle; padding: 1px 1px; margin-top: 0.1em; border: 1px solid #000; border-radius: 8px 8px 8px 8px; color: #FFFFFF;"; var tPic = fPart + "background-color:#666666;'>● " + c.get('name') + ' ●</div>'; var Pic = fPart + "background-color:#AAAAAA;'><img src='" + c.get('avatar') + "'></div>"; sendChat('', '/direct ' + tPic + Pic); } } }); }); Example macros: !char-pic @{Bob|character_id} or !char-pic @{target|Who?|character_id} Resize Turn Tracker:
a per-session bookmarklet that reduces the size of the turn tracker. <a href="https://app.roll20.net/forum/permalink/2317121/" rel="nofollow">https://app.roll20.net/forum/permalink/2317121/</a> javascript:(function(){ $('#initiativewindow .characterlist .name').hide();$('#initiativewindow').parent().css('width','100px'); })();
Here's one that sets it back:
javascript:(function(){ $('#initiativewindow .characterlist .name').show();$('#initiativewindow').parent().css('width','200px'); })(); You can actually do this locally via a Bookmarklet: For Chrome, you just create bookmarks with the above in them. During the game, you choose the one you want and it makes the changes. These changes are local and only persist until you reload. [Stylish] 4-Column Initiative with 1 column for editing!:
make the Turn Order 4 columns, but when you go to manipulate it, it reverts to a single column. <a href="https://app.roll20.net/forum/permalink/5230924/" rel="nofollow">https://app.roll20.net/forum/permalink/5230924/</a> /* Comment out this part to have single columns... */
#initiativewindow .characterlist {
-moz-column-count: 4;
-moz-column-gap: 20px;
-webkit-column-count: 4;
-webkit-column-gap: 20px;
column-count: 4;
column-gap: 20px;
}
#initiativewindow .characterlist:hover {
-moz-column-count: 1;
-webkit-column-count: 1;
column-count: 1;
}
/* ...down to here. */
#initiativewindow .characterlist .token .name{
font-size: 1em !important;
}
#initiativewindow .characterlist .token .initiative{
font-size: 1em !important;
background-color: #ccc;
font-weight: bold;
border-radius: .5em;
}
#initiativewindow {
padding: 1px 1px;
overflow-x: auto;
position:relative;
}
#initiativewindow ul li {
padding: 1px;
white-space: nowrap;
}
#initiativewindow ul li {
min-height: 15px
}
#initiativewindow ul li img {
max-width: 20px;
max-height: 15px;
}
#initiativewindow ul li .controls {
font-size: 15px;
padding: 1px;
}
#initiativewindow ul li span.initiative {
font-size: 18px;
padding: 2px;
min-height: 12px;
z-index: 1000;
position:relative;
}
#initiativewindow ul li span.name {
font-size: 14px;
padding-top: 2px;
}
#initiativewindow input {
font-size: 15px;
height: 15px;
}
.ui-dialog-titlebar {
padding: 2px !important;
}
.ui-dialog-titlebar .ui-dialog-title {
margin: 0 !important;
font-size: 10px;
line-height: 10px;
}
.ui-dialog-buttonpane {
margin: 0 20px 0 0 !important;
padding: 1px !important;
}
.ui-button {
font-size: 10px !important;
line-height: 10px !important;
padding: 1px 3px !important;
}
.ui-button.bigbuttonwithicons .ui-button-text {
font-size: 10px !important;
}
Here is what it looks like with those first two styles commented out so that it has a single column: Note, this will also affect the size of headers and buttons on other dialogs, like dealing cards, designing decks, making rollable tables, etc.. Highlight Audio Playing Jukebox:
a per-session bookmarklet that highlights all currently playing tracks in the audio tab. <a href="https://app.roll20.net/forum/permalink/1936428/" rel="nofollow">https://app.roll20.net/forum/permalink/1936428/</a> javascript:(function(){_.each($('#jukebox').find('tr'),function(r){var $r=$(r),$b=$($r.find('button'));if($b.hasClass('pause')){$r.css({backgroundColor: '#ff0000'});}});}()); Just make a bookmark with that as the URL. When you click it while on the Roll20 VTT, it will change the background of any playing tracks to bright red. =D The highlight goes away whenever you click a button. Clear UI:
a per-session bookmarklet that that hides the UI. <a href="https://app.roll20.net/forum/permalink/1176273/" rel="nofollow">https://app.roll20.net/forum/permalink/1176273/</a> Ok. Here's a JavaScript Bookmark-let that will hide all the UI for you. Just make a bookmark in Chrome (should work in FF too, but didn't try it there) with a title like " Roll20: Clear UI " and the URL like this: javascript:(function(){$("#zoomslider").css("display","none");$("#floatingtoolbar").css("display","none");$("#sidebarcontrol").css("display","none").click();$("#playerzone").css("display","none");$("#initiativewindow").parent().css("left","-10000px")})(); Alternate version used on GM view(thanks Pringle) All credit still to The Aaron (this change is tiny), but if you want to use this on a GM view and hide the blue tab then use: javascript:(function(){$("#zoomslider").css("display","none");$("#floatingtoolbar").css("display","none");$("#sidebarcontrol").css("display","none").click();$("#playerzone").css("display","none");$("#initiativewindow").parent().css("left","-10000px");$("#page-toolbar").css("display","none")})(); Expand Page Toolbar:
a per-session bookmarklet that sets the height and prevents wrapping of the page toolbar. <a href="https://app.roll20.net/forum/permalink/1081664/" rel="nofollow">https://app.roll20.net/forum/permalink/1081664/</a> Make a bookmark in your browser, but put this in the url: javascript:(function(){ $('#page-toolbar').height('800px');$('#page-toolbar .container').css({height: '800px','white-space': 'normal'});}()); When you are on the VTT and choose it, it will make the page bar display much taller and wrapping. You won't be able to sort pages with it like this, but you can grab the player flag and move it to any of the displayed pages (the flag stays on the top row, but it will move the players to the page you highlight with the blue border.). Refreshing the page will restore the page bar to normal. Increase Font-size for Chat:
a per-session bookmarklet that increases the font-size of chat. <a href="https://app.roll20.net/forum/permalink/1276072/" rel="nofollow">https://app.roll20.net/forum/permalink/1276072/</a> javascript:$('#textchat').css('font-size','1.5em'); Just make a bookmark in chrome, but put the above as the URL. When you're on the VTT, select that bookmark and it will change all the text in the chat area to the 1.5em size (which is about 50% larger). When you refresh the page, it will go back to normal. You can change the 1.5em to whatever size you like. =D Sort Transmogrifier list: <a href="https://app.roll20.net/forum/permalink/4891027/" rel="nofollow">https://app.roll20.net/forum/permalink/4891027/</a> javascript:$('iframe').contents().find('.objects').each((c,e)=>{ let $e=$(e); $e.children().sort( (a,b)=>{ let name1=$(a).find(".name").text().toLowerCase(), name2=$(b).find(".name").text().toLowerCase(), comp = name1.localeCompare(name2); return comp; }) .each((i,c)=>$e.append(c)); }); This is a bookmarklet that will sort your transmogrifier lists. In Chrome, just make a new bookmark with the above as the link. When you have the transmogrifier open and select this link, it will sort the currently open lists. You'll need to run it again when you choose a new list or after dragging things across to get the list back in order. Cycle thru Token Ability Macros: <a href="https://app.roll20.net/forum/permalink/4891568/" rel="nofollow">https://app.roll20.net/forum/permalink/4891568/</a> javascript:(function(){ "use strict"; $('body').keydown(function(e) { var n,o,t; if( e && e.altKey && (48 <= e.keyCode) && (58 >= e.keyCode) ){ n=e.keyCode - ( 48===e.keyCode ? 38 : 49 ); o=$('#secondary-toolbar ul.mode.tokenactions'); if(o && 'none' !== o.css('display')) { t=o.children()[0].children[n]; if(t) { t.click(); } } } }); }());
It lets you hit alt-1 through alt-0 to activate one of the first 10 Token Action buttons on the selected token. Copy ALL API Scripts: <a href="https://app.roll20.net/forum/permalink/2995136/" rel="nofollow">https://app.roll20.net/forum/permalink/2995136/</a> You can use this JavaScript Bookmark-let to build a text area with all the scripts concatenated: javascript:$('<textarea></textarea>').attr({id: 'TheAaronAllScripts'}).css({width:'100%',height: '30em'}).text($('.script .editor').map(function(idx,e){return e.env.editor.getValue();}).toArray().join("\n/* ############################### */;\n\n")).appendTo('body'); The above you can copy and put in a bookmark in Chrome. For Firefox, you need a link to right click and add bookmark, so far as I know. This might work to copy in Firefox: <a href="http://javascript:$(' Bookmark-let Copy Only ACTIVE API Scripts: https://app.roll20.net/forum/permalink/5019380/ javascript: (function(){let disabledScripts=$('ul.nav.nav-tabs li a.disabled').map((idx,e)=>$(e).attr('href').substr(1));$('<textarea></textarea>').attr({id: 'TheAaronAllScripts'}).css({width:'100%',height: '30em'}).text($('.script.tab-pane').filter((idx,e)=>!_.contains(disabledScripts,$(e).attr('id'))).map((i,e)=>$('.editor',e)[0]).map(function(idx,e){return e.env.editor.getValue();}).toArray().join("\n/* ############################### */;\n\n")).appendTo('body'); }());
User Library Image Download Helper: https://app.roll20.net/forum/permalink/5153640/ Here is a bookmark-let that will work with the Recent Uploads Dialog: javascript:(function(){ var links=$('#libraryview .library-container').map(function(idx,block){ var $block=$(block), img=$block.find('img'),name=$block.find('.library-labelcontainer span').text(), ext = img.attr('src').match(/\b(?:thumb|max|original)\b\.(\w*)/)[1]; return $('<a style="border:1px solid #999;float:left;display:block;width:52px;height:52px;" href="'+img.attr('src').replace(/\b(?:thumb|max)\b/,'original')+'" download="'+name+'.'+ext+'"><img style="max-width:50px;max-height:50px;" src="'+img.attr('src').replace(/\b(?:thumb|max)\b/,'original')+'"></a>').click(function(){$(this).css('opacity',0.5);});}).toArray(); $('<div style="position:absolute;width:100%;height:100%;overflow-y:auto;top:0;left0;z-index:1000000;background-color: #ccc;"></div>').html(links).appendTo('body');}()); In chrome, make a bookmark with that as the link named something like "User Library Image Download Helper". In one of your games, Click a recent upload image (1), to open the Recent Uploads Dialog (2), then scroll down until it's done loading images (3): Once you don't see the "Loading Recent Uploads..." thing, select that created bookmark. It will then build a grid of all your user library images. This might take a few minutes, as the thumbnail sized images are really the full size originals. Each of those is a clickable link to the original image. When I originally wrote a version of this for the external user library, you could click each one and download the image easily. That wasn't working for me in latest chrome in this version, so you might have to right click and download each image (clicking the image will grey it out, so you can use that to keep your place. Unfortunately, they'll all be named original something, so you'll have to rename as you go or not worry about the name. YMMV. Campaign "Born on" date script: https://app.roll20.net/forum/permalink/5197532/ Will give you it's best guess about the creation date of your game. If the game is olde enough, it might output garbage.. YMMV... on('ready',function(){
let createdOn=new Date(_.chain(getAllObjs())
.map((o)=>o.id)
.reject((id)=>id==='root')
.map((id)=>_.reduce( (id||'').substring(0,8).split(''), (m,c)=>{
return (m*64)+("-0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZ_abcdefghijklmnopqrstuvwxyz".indexOf(c));
},0))
.sortBy(_.identity)
.first()
.value()||0*1000);
sendChat('Created on Date (Best Guess)',`/w gm ${createdOn}`);
});
GM is rolling script: https://app.roll20.net/forum/permalink/5790953/ If you want a script for it, you could use this: on('ready',()=>{
on('chat:message',(msg)=>{
if('gmrollresult'===msg.type && playerIsGM(msg.playerid)){
sendChat('...','the GM is rolling...');
}
});
});
if the GM uses /gmroll or /gr
Re-Number Tokens mod:
https://app.roll20.net/forum/permalink/11725508/
Here's one that's a little smarter. It will rebuild the names of tokens if they represent a character, and number individually all the tokens representing that character.
!renumber-selected
on('ready',()=>{ on('chat:message',msg=>{ if('api'===msg.type && /^!renumber-selected(\b\s|$)/i.test(msg.content) && playerIsGM(msg.playerid)){ let args = msg.content.split(/\s+/); let numBase = (parseInt(args[1])||1)-1; let tcmap = (msg.selected || []) .map(o=>getObj('graphic',o._id)) .filter(g=>undefined !== g) .reduce((m,t)=>{ const rep=t.get('represents')||'%%NOCHAR%%'; m[rep]=m[rep]||[]; m[rep].push(t); return m; },{}); Object.keys(tcmap).forEach( c => { let ts = tcmap[c]; let n = numBase; let numer = (t) => { let baseName = t.get('name').replace(/\s+\d*$/,''); t.set('name', `${baseName} ${++n}`); }; if('%%NOCHAR%%' !== c){ // number character tokens let character = getObj('character',c); if(c) { numer = (t) => { t.set('name', `${character.get('name')} ${++n}`); }; } } ts.forEach(numer); }); } }); }); Rando Token Image:
https://app.roll20.net/forum/permalink/11763269/
Should randomly change the face of any token added to the tabletop which isn't a player token. on('ready',()=>{
const playerCanControl = (obj, playerid='any') => {
const playerInControlledByList = (list, playerid) => list.includes('all') || list.includes(playerid) || ('any'===playerid && list.length);
let players = obj.get('controlledby')
.split(/,/)
.filter(s=>s.length);
if(playerInControlledByList(players,playerid)){
return true;
}
if('' !== obj.get('represents') ) {
players = (getObj('character',obj.get('represents')) || {get: function(){return '';} } )
.get('controlledby').split(/,/)
.filter(s=>s.length);
return playerInControlledByList(players,playerid);
}
return false;
};
const getCleanImgsrc = (imgsrc) => {
let parts = imgsrc.match(/(.*\/images\/.*)(thumb|med|original|max)([^?]*)(\?[^?]+)?$/);
if(parts) {
return parts[1]+'thumb'+parts[3]+(parts[4]?parts[4]:`?${Math.round(Math.random()*9999999)}`);
}
return;
};
const isString = (s)=>'string'===typeof s || s instanceof String;
let tokenIds = [];
const saveTokenId = (obj) => {
tokenIds.push(obj.id);
};
const setTokenRandomSide = (obj,prev,force=false) => {
if(tokenIds.includes(obj.id) || force){
tokenIds=tokenIds.filter(id => id !== obj.id);
if( 'graphic' === obj.get('type') && 'token' === obj.get('subtype') && ! playerCanControl(obj)){
let sideText = obj.get('sides');
if( sideText.length ){
let sides = sideText.split(/\|/).map(decodeURIComponent).map(getCleanImgsrc).filter(isString);
if(sides.length){
obj.set({
imgsrc: sides[randomInteger(sides.length)-1]
});
}
}
}
}
};
on('add:graphic', saveTokenId);
on('change:graphic', setTokenRandomSide);
});
Macro-Cleanup:
https://app.roll20.net/forum/permalink/11763547/ And hit the ❌ next to a player name to remove all their macros. You can also remove individual macros with the ❌ next to them. !macro-cleanup code: on('ready',() => {
// ❌
const s = {
button: `font-size: .6em; border: 1px solid #999;background-color: #ccc; border-radius: 1em; padding: .1em .3em;min-width:1.5em;text-align:center;`,
tokenAction: `background: green; font-weight: bold; border: 1px solid #333; color: white;`
};
const playerName = (()=>{
let players = findObjs({type:'player'})
.reduce((m,p)=>({...m, [p.id]: p.get('displayname')}),{});
return (pid) => players[pid] || '[Unknown]';
})();
const f = {
li: (c) => `<li>${c}</li>`,
ul: (c) => `<ul>${c}</ul>`,
ol: (c) => `<ol>${c}</ol>`,
b: (c) => `<b>${c}</b>`,
subhead: (c) => `<h4>${c}</h4>`,
ta: () => `<span style="${s.tokenAction}">TA</span>`,
button: (label,command) => `<a style="${s.button}" href="${command}">${label}</a>`,
mac: (m) => `${f.b(m.get('name'))} ${m.get('istokenaction') ? f.ta() : ''} ${f.button(`❌`,`!macro-cleanup ${m.id}`)}`,
pla: (p,ms) => `${f.subhead(`${playerName(p)} ${f.button(`❌`,`!macro-cleanup ${ms.map(m=>m.id).join(' ')}`)}`)}${f.ul(ms.map(f.mac).map(f.li).join(''))}`,
tree: (tree) => Object.keys(tree).map(pid=>f.pla(pid,tree[pid])).join('')
};
on('chat:message', (msg) => {
if('api' === msg.type && /^!macro-cleanup(\b\s|$)/i.test(msg.content) && playerIsGM(msg.playerid) ){
let who = (getObj('player',msg.playerid)||{get:()=>'API'}).get('_displayname');
let args = msg.content.split(/\s+/).slice(1);
if(args.length){
_.chain(args)
.map((id)=>getObj('macro',id))
.reject(_.isUndefined)
.tap((ms)=>sendChat('',`/w "${who}" ${ms.length} removed.`))
.each((m)=>m.remove());
} else {
let macroTree = findObjs({type:'macro'})
.reduce((m,mac)=>({
...m,
[mac.get('playerid')]:[
...(m[mac.get('playerid')]||[]),
mac
]
}),{});
sendChat('',`/w "${who}" ${f.tree(macroTree)}`);
}
}
});
});
