You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
// This script will duplicate a character sheet and token giving the new characters and tokens an identifying number and
5
+
// linking each new token to it's own individual new character sheet.
6
+
// This script is useful for those who want to create multiple copies of monsters because they prefer multiple character sheets to linking tokens as Mooks.
7
+
// Using an argument of "clean" causes it to clean up (delete) numbered tokens and characters such as this script creates.
8
+
//
9
+
// Examples:
10
+
// If you select a token named "Skel" that is linked to a character named "Skeleton", and in the chat window enter
11
+
// !DupCharToken 5
12
+
// It will make 5 new characters, identical to the original, named "Skeleton 1" through "Skeleton 5",
13
+
// and make 5 new tokens, identical to the original and stacked in the exact same location, named "Skel 1" through "Skel 5".
14
+
// Each token will be linked to its corresponding character sheet in the exact same manor as the originals were linked.
15
+
//
16
+
// If later on you select any token named "Skel" or "Skel (number)" and enter
17
+
// !DupCharToken clean
18
+
// It will delete all tokens where the name is "Skel (any number)" and all characters named "Skeleton (any number)".
19
+
// The original token and character (without a number) will not be deleted.
20
+
//
21
+
//
22
+
// Known bugs/issues:
23
+
// 1 - If the avatar image of the character is not in a user library (i.e: it's a marketplace image or from the Monster Manual, or the like),
24
+
// due to limits placed upon the API, it can't set an avatar image. You will have to do that yourself, or (better yet)
25
+
// copy the image to your own library on roll20, and set the token to be copied to use the image in your library.
26
+
// Two ways to copy the image to your own library on roll20 are as follows:
27
+
// A) download an image and then upload it manually, either by downloading the set,
28
+
// or placing a copy on the VTT, pressing "z" and right clicking the preview.
29
+
// or
30
+
// B) Right click the image in your marketplace collection (in the art library) and choosing "Copy to Library" or "Copy to Folder"
31
+
// B is probably faster, unless you are working with a whole set.
32
+
// After downloading the image to your own Roll20 library, make sure the Character and Token to be copied uses that image.
33
+
// 2 - It takes a while to make copies, If making lots of copies of characters with lots of attributes, it might be several minutes between the
34
+
// message that the copy has started, and the message that it has ended.
35
+
// This is OK except that the character copy is not done until the ending msg comes.
36
+
// 3 - Version 01.00 had unknown problems with the Roll20 script library, where the script could not be added or imported from the script library.
37
+
// The script would work if it was gotten from GitHub and pasted into an API screen, but did not work from the script library.
38
+
// It is hoped that version 1.01 will fix this, but if not, get it from the script library.
39
+
//
40
+
//
41
+
// This script is based upon a script by "The Aaron".
// It has been modified to it's current form by Chris Dickey (Roll20 user "Chris D").
44
+
// Version 01.00 Dec 2018 Chris D. Original release.
45
+
// Version 1.01 Nov 2019 Chris D. After all characters have been created, do loops to read attributes and abilities once and create for each new character.
46
+
// Version 1.02 Jan 2020 Chris D. Fixed bug where script would crash API if clean was run with no tokens selected.
47
+
// Version 1.03 Mar 2020 Chris D. Tokens dragged from the journal would not be correctly linked. Moved setDefaultTokenForCharacter to occur after attributes are copied.
48
+
// Update 1.031 May 2020 Chris D. Minor bugfix with copying bio and gmnotes.
49
+
// Update 1.04 Sep 2020 Chris D. Fixed the bug where it would timeout, killing api sandbox, if copying too many attributes.
50
+
//
51
+
//
52
+
// Commands:
53
+
// !DupCharToken (Number of tokens to create) (Starting number)
54
+
// !DupCharToken clean
55
+
// Number to create is the number of characters and tokens to copy/create. It defaults to 1.
56
+
// Starting number is the number to start numbering the tokens and characters from. Defaults to 1.
57
+
// So !dupCharacter 5 3 would start numbering at 3 ending at number 7.
58
+
//
59
+
// You can add the following text to a macro
60
+
// !dupCharToken ?{How many Duplicates|1} ?{Starting Number|1}
if(/\bclean\b/i.test(msg.content)||/\bdelete\b/i.test(msg.content)){// We are not duplicating, we are cleaning up characters and tokens that we created previously.
77
+
lettnames=[],
78
+
cnames=[];
79
+
if(!msg.selected||msg.selected.length==0)
80
+
sChat("Please select exactly one token representing the character to duplicate. Script usage is !DupCharToken (Number of tokens to create) (Starting number) or !DupCharToken clean");
81
+
else{
82
+
_.each(msg.selected,function(sel){// for each token selected, find base token name and base character name. add unique ones to list.
83
+
lettokenObj=getObj('graphic',sel._id);
84
+
if(_.isUndefined(tokenObj))
85
+
sChat("Token is invalid in some way.");
86
+
else{
87
+
lettn=tokenObj.get("name").replace(/\s+\d+\s*$/,"");// one or more whitespaces, one or more digits, zero or more whitespaces, then the end of line get trimmed off.
sChat("Token is not correctly linked to a good character.");
93
+
else{
94
+
letcn=charObj.get("name").replace(/\s+\d+\s*$/,"");// one or more whitespaces, one or more digits, zero or more whitespaces, then the end of line get trimmed off.
95
+
if(cnames.indexOf(cn)==-1)
96
+
cnames.push(cn);
97
+
}
98
+
}
99
+
});// end each selected token
100
+
101
+
functiongetRegEx(arr){// skel, ork.
102
+
letre="^(";
103
+
arr.forEach(function(nm){re+=nm+"|";});
104
+
returnnewRegExp(re.slice(0,-1)+")\\s\\d+\\s*$");
105
+
};
106
+
if(tnames.length){// search for token names. for each found token, delete.
if(cnames.length){// search for character names, for each, delete.
119
+
letreg=getRegEx(cnames),
120
+
d=[];
121
+
_.each(findObjs({type:"character"}),(cObj)=>{
122
+
if(reg.test(cObj.get('name'))){
123
+
d.push(cObj.get('name'));
124
+
cObj.remove();
125
+
}
126
+
});
127
+
sChat("Deleted characters: "+d.join()+".");
128
+
}
129
+
}
130
+
// End clean
131
+
}elseif(!msg.selected||msg.selected.length!==1)
132
+
sChat("Please select exactly one token representing the character to duplicate. Script usage is !DupCharToken (Number of tokens to create) (Starting number) or !DupCharToken clean");
133
+
else{// Not cleaning up, presumably duplicating.
134
+
letnum=1,
135
+
startnum=1;
136
+
letcl=msg.content.split(/\s+/);
137
+
if(cl.length>1){
138
+
if(parseInt(cl[1]))
139
+
num=parseInt(cl[1]);
140
+
else{
141
+
sChat("Script usage is !DupCharToken (Number of tokens to create) (Starting number) or !DupCharToken clean");
"description": "This script will duplicate a character sheet and tokens giving the new characters and tokens an identifying number and linking each new token to it's own individual new character sheet. This script is useful for those who want to create multiple copies of monsters because they prefer multiple character sheets to linking tokens as Mooks. Using an argument of 'clean' causes it to clean up (delete) numbered tokens and characters such as it creates.\r\r## Commands:\r\r```!DupCharToken <Number of tokens to create (defaults to 1)> <Start numbering from (defaults to 1)>```\r\r```!DupCharToken clean```\r\rYou can add the following text to a macro\r```!DupCharToken ?{How many Duplicates|1} ?{Starting Number|1}```\r\r## Examples:\r\rIf you select a token named 'Skel' that is linked to a character named 'Skeleton', and in the chat window enter```!DupCharToken 5```\r\rIt will make 5 new characters, identical to the original, named 'Skeleton 1' through 'Skeleton 5', and make 5 new tokens, identical to the original and stacked in the exact same location, named 'Skel 1' through 'Skel 5'. Each token will be linked to its corresponding character sheet in the exact same manor as the originals were linked.\r\rIf later on you select any token named 'Skel' or 'Skel (number)' and enter```!DupCharToken clean```\rIt will delete all tokens where the name is 'Skel (any number)' and all characters named 'Skeleton (any number)'. \rThe original token and character (without a number) will not be deleted.\r\r\r## Known bugs/issues:\r If the avatar image of the character is not in a user library (i.e: it's a marketplace image or from the Monster Manual, or the like), due to limits placed upon the API, it can't set an avatar image. You will have to do that yourself (or copy the image to the library).\r\r For more information please see [CharDupToken script wiki page](https://wiki.roll20.net/Script:DupCharToken)",
0 commit comments