ServUO Client API (Replacement for art API)

[dmurphy]

Today I have finished my rewrite of the Art API from PHP to c# and asp.

The API no longer serves just art but will serve most client information a user requires. As time goes on more information will be added to the endpoint.

Right now what is available:

• Item art
• Gump art
• Multi art
• Animations (new)
• Sounds(new)

I will continue to add to this list as time goes on.

Not only that but the API is open source now under the GNU v3 license and anyone is free to submit bug fixes and features or use it for their own needs.

Endpoints are available at: http://services.servuo.com/API
Source at: https://github.com/ServUO/Client-API
Have fun!

 

[zerodowned]

Thank for both updating it and for making it open source!

 

[john burns]

So we download this to our server or our webpage?

I see what you did, I like what you did, just trying to understand what you did.

 

[dmurphy]

It is a web based project. You can pull client files such as item images or animations and include them dynamically in your own projects. The most appropriate use of this would be to include images on your own website. I will come up with some example code that should help explain it soon.

 

[john burns]

and we can use this code on our web pages from ServUO directly? Not our servers?

 

[dmurphy]

and we can use this code on our web pages from ServUO directly? Not our servers?

The source code is available if you want to host the API yourself on your own server, however it is an ASP based project so would require a windows host (Untested on mono)

Here is a quick simple example an animation of the human bodyvalue walking while hued purple

 

[john burns]

Ok, I see.

Install into our own server, then have our webpages do an image link to the api requesting a certain picture, then if we decide to, we hue it what color we want.

Sounds simple until you try using it. LOL.

* * * * E D I T * * * *
On a side note, with this package, it will save on space when you decide to host your webpage.

 

[dmurphy]

Ok, I see.

Install into our own server, then have our webpages do an image link to the api requesting a certain picture, then if we decide to, we hue it what color we want.

Sounds simple until you try using it. LOL.

Yep pretty much, but you do not need to install it on your own server. I only request that from people who will pull thousands of requests per day. For 99% of users the ServUO hosted version will do just fine.

 

[john burns]

I would prefer to install it myself. Just for the custom stuff. And for general purpose.
Nothing against you.
Its me.
And I am sure alot of people will feel this way too. But thanks for giving us options.

 

[dmurphy]

I would prefer to install it myself. Just for the custom stuff. And for general purpose.
Nothing against you.
Its me.
And I am sure alot of people will feel this way too. But thanks for giving us options.

No problem. People with custom files were one of the main reasons I decided to open source it. If you decide to use it let me know. I would love to see projects that implement it.

 

[john burns]

No problem. People with custom files were one of the main reasons I decided to open source it. If you decide to use it let me know. I would love to see projects that implement it.

Now for the REALLY big question.....
where is it?

* * * * E D I T * * * *
Can I use git-hub to get it?

 

[dmurphy]

Link is at the bottom of the first post.

https://github.com/ServUO/Client-API

 

[john burns]

I tried using github to get the package, but it told me everything was up-to-date.
[doublepost=1465365981][/doublepost]Now, which folder do I place this into?

 

[SomeRandomDude]

I'll test it on MONO. Thx @dmurphy ! You're the boss

 

[dmurphy]

Update

Changes:

• New feature: Paperdoll builder. See below for information
• Bugfix: Fix for item art hues being one off.

Paperdoll builder:

This is a neat feature that allows you to pass in gear for the system to build a paperdoll image.

This is what the endpoint expects: <BodyHue>:<Isfemale>,<ItemID>:<Hue>,<ItemID>:<Hue>,<ItemID>:<Hue>,<ItemID>:<Hue>,......

An example of this is:

http://services.servuo.com/uoapi/paperdoll?gear=1003:false,50434:849,50543:0,50480:1711,50544:0,50542:0,50546:0,50545:0,50984:0,50560:0,

Which will result in

 

[xG00BERx]

This is some cool stuff. I see some potentially awesome things coming from this! Keep it up everyone! Especially Dmurph!

 

[dmurphy]

New feature: Avatar generation from paperdoll.

Just a simple extension of the previous paperdoll update. Apped ?avatar=true to your uri for it to happen.

N.B. because UO art files are all so low resolution the avatars generated are not so pretty.

Example useage:

http://services.servuo.com/uoapi/paperdoll?gear=1003:false,50434:849,50543:0,50480:1711,50544:0,50542:0,50546:0,50545:0,50984:0,50560:0&avatar=true

Output:

 

[BrianFreud]

Very cool - I was wishing for a way to generate some hued hair pics just the other day.

For item images, I wonder is there a way to generate stacked images? So 1 gp, 3 gp, 6 gp, 2 bandages, etc? I'm pretty sure gold all is the same itemtype, though I've not looked yet to see if there's a different internal image number for stacks.

 

[Vorspire]

3821 - 1 coin


3822 - 2-5 coins


3823 - 6+ coins

 

[BrianFreud]

Ok lol, gold was a bad example (though interesting that EUO maps all three to the same itemtype). Most stacks, though, I don't think have separate images for stacks - reagents, bandages, grass, snow, etc. Seems to be a standard offset, then the same graphic layered over top of the first instance of the graphic.

@dmurphy, a suggestion for the mob API; rather than animated or static, a third option, where the static image from each angle cycles, for showing off what the mob looks like. Basically what you'd get by turning these into a gif, possibly with a flag to set whether you're cycling 0>7, or 7>0, to control which direction the mob appears to spin in:

http://services.servuo.com/uoapi/anim/987/0/0/true
http://services.servuo.com/uoapi/anim/987/0/1/true
http://services.servuo.com/uoapi/anim/987/0/2/true
http://services.servuo.com/uoapi/anim/987/0/3/true
http://services.servuo.com/uoapi/anim/987/0/4/true
http://services.servuo.com/uoapi/anim/987/0/5/true
http://services.servuo.com/uoapi/anim/987/0/6/true
http://services.servuo.com/uoapi/anim/987/0/7/true